home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / commo51.arc / COMMO.DOC < prev    next >
Encoding:
Text File  |  1991-12-22  |  133.2 KB  |  3,454 lines
  1.  
  2.  
  3.  
  4.                                    ____________
  5.  
  6.                                    {COMMO} (tm)
  7.                                    ____________
  8.  
  9.  
  10.                       "A New Standard in Telecommunications"
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.                                         by
  18.  
  19.                                   Fred P. Brucker
  20.  
  21.                                Post Office Box 9103
  22.                                Santa Rosa, CA 95405
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.                              User Guide and Reference
  30.  
  31.  
  32.  
  33.  
  34.                                     Release 5.1
  35.  
  36.                                  December 21, 1991
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.        This program and associated documentation are the property of the
  44.        author and may not be sold without permission.  They may be freely
  45.        distributed, unaltered and as a unit, via electronic bulletin board
  46.        systems.  Permission to distribute on diskette or in any other
  47.        manner must be obtained in writing.  See the file LICENSES for
  48.        additional licensing and distribution details.
  49.  
  50.        The author does not guarantee this program to be free from defects
  51.        and may not be held responsible for loss caused by such.  Your use
  52.        of this program constitutes your acceptance of these terms.
  53.  
  54.  
  55.  
  56.  
  57.            (C)Copyright 1989,1991  Fred P. Brucker  All Rights Reserved
  58.  
  59.  
  60.  
  61.        ========================
  62.        Registration Information
  63.        ========================
  64.  
  65.        {COMMO} is a "SHAREWARE" product.  You are entitled to evaluate it
  66.        for 30 days.  If it suits your needs and you would like to continue
  67.        using it, then you must pay the licensing fee.  Please use the order
  68.        form in the file REGISTER.FRM (or the one below).
  69.  
  70.           Send to:       Fred P. Brucker
  71.                          Post Office Box 9103
  72.                          Santa Rosa, CA 95405
  73.  
  74.        When you REGISTER you will be licensed to use all future releases of
  75.        {COMMO}.  You will never have to pay an "update" charge.  You will
  76.        also receive instructions for removing the Shareware Notice at
  77.        program startup.
  78.  
  79.        My (voice) TELEPHONE NUMBER for inquiries and support for registered
  80.        users is (707) 573-1065.  Please restrict calls to business hours
  81.        (Mon-Fri, 9am-5pm, Pacific time).
  82.  
  83.        Registered users will also receive priority support on Bulletin
  84.        Boards, CompuServe and GEnie (see READ.ME).
  85.  
  86.        Call or write for pricing information on MULTI-USER (site) licenses. 
  87.        Discounts are given on quantities greater than 10.
  88.  
  89.        See the file LICENSES for licensing and distribution details.
  90.  
  91.  
  92.  
  93.  
  94.                      {COMMO} 5.1 SINGLE USER REGISTRATION FORM
  95.  
  96.  
  97.        Name     ___________________________________________________________
  98.  
  99.        Company name (if company address)   ________________________________
  100.  
  101.        Address  ___________________________________________________________
  102.  
  103.                 ___________________________________________________________
  104.  
  105.                 ___________________________________________________________
  106.  
  107.        ====================================================================
  108.                          All prices shown are US DOLLARS.
  109.                       Please remit US funds on US bank only.
  110.         NET 30 TERMS will be accepted on orders totalling $100.00 or more.
  111.                      Payment accepted as check or money order,
  112.                             payable to FRED P. BRUCKER.
  113.               SORRY, I am unable to accept credit cards at this time.
  114.        ====================================================================
  115.  
  116.        {COMMO} single user license, SPECIAL PACKAGE ... $50.00   $ ________
  117.           Includes: (1) Printed, bound, indexed manual.
  118.                     (2) Latest release on diskette plus utilities
  119.                         (COMMOPNS, MOSTHOST, CMC, etc., see READ.ME).
  120.                             Choose format: 5.25" ____ 3.5" ____
  121.                             Current release  ____  or next ____
  122.  
  123.        {COMMO} single user LICENSE only ................ $35.00  $ ________
  124.           You may also order a diskette.
  125.  
  126.        Registered users may order PRINTED MANUAL only .. $20.00  $ ________
  127.           Limit of one per license.  Your serial no. _________
  128.  
  129.        Registered users may order DISKETTE only ........  $5.00  $ ________
  130.            Limit of one per license.  Your serial no. _________
  131.                             Choose format: 5.25" ____ 3.5" ____
  132.                             Current release  ____  or next ____
  133.  
  134.                                                        Subtotal  $ ________
  135.  
  136.                     California residents add sales tax, 7.5%     $ ________
  137.                       (No tax when ordering license alone)
  138.  
  139.        Special Package or Manual order, add SHIPPING:
  140.                               USA/Canada/Mexico ........  $3.00
  141.                               All other countries ...... $10.00  $ ________
  142.  
  143.                                                        Total     $ ________
  144.  
  145.  
  146.        Thank you, and I hope you enjoy {COMMO}.
  147.  
  148.  
  149.  
  150.                    {COMMO} (tm)  User Guide and Reference           page ii
  151.  
  152.  
  153.        ========
  154.        Contents
  155.        ========
  156.  
  157.  
  158.           Preface . . . . . . . . . . . . . . . . . . . . . . . . . . .  iv
  159.  
  160.           Principal Features  . . . . . . . . . . . . . . . . . . . . .   1
  161.                The Best Way to Learn {COMMO} Quickly  . . . . . . . . .   3
  162.  
  163.           Getting Started . . . . . . . . . . . . . . . . . . . . . . .   3
  164.                Quick Start Instructions . . . . . . . . . . . . . . . .   3
  165.                Preparing Your System  . . . . . . . . . . . . . . . . .   5
  166.                Command Line Options . . . . . . . . . . . . . . . . . .   7
  167.                {COMMO} Support Files  . . . . . . . . . . . . . . . . .   8
  168.                Saving the Support Files . . . . . . . . . . . . . . . .   9
  169.                Initialization Procedure . . . . . . . . . . . . . . . .  10
  170.                Terminal Screen  . . . . . . . . . . . . . . . . . . . .  10
  171.  
  172.           {COMMO} Key Commands  . . . . . . . . . . . . . . . . . . . .  11
  173.                [Alt-A]   ASCII Upload . . . . . . . . . . . . . . . . .  11
  174.                [Alt-B]   Send Break Signal  . . . . . . . . . . . . . .  13
  175.                [Alt-C]   Clear Screen . . . . . . . . . . . . . . . . .  13
  176.                [Alt-D]   Dialing Directory  . . . . . . . . . . . . . .  13
  177.                     Dialing Directory Entry Example . . . . . . . . . .  14
  178.                [Alt-G]   Edit Setup File  . . . . . . . . . . . . . . .  17
  179.                     Predefining Variables with SET  . . . . . . . . . .  17
  180.                     Explanation of Setup File Items . . . . . . . . . .  18
  181.                [Alt-H]   Hang Up  . . . . . . . . . . . . . . . . . . .  29
  182.                [Alt-I]   Screen Image Save  . . . . . . . . . . . . . .  29
  183.                [Alt-K]   Scrollback . . . . . . . . . . . . . . . . . .  29
  184.                [Alt-M]   Macro Processor  . . . . . . . . . . . . . . .  30
  185.                [Alt-N]   Multi Number Dialing . . . . . . . . . . . . .  30
  186.                [Alt-O]   Send Modem Initialization String . . . . . . .  31
  187.                [Alt-P]   Set Terminal Parameters  . . . . . . . . . . .  31
  188.                     Parameter Descriptions  . . . . . . . . . . . . . .  31
  189.                     Setting Terminal Parameters . . . . . . . . . . . .  33
  190.                [Alt-S]   Shell to DOS . . . . . . . . . . . . . . . . .  34
  191.                [Alt-T]   Set Toggles  . . . . . . . . . . . . . . . . .  34
  192.                     Sound Control Toggle  . . . . . . . . . . . . . . .  34
  193.                     AutoBaud Toggle . . . . . . . . . . . . . . . . . .  34
  194.                     Local Echo Toggle . . . . . . . . . . . . . . . . .  35
  195.                     Signal Lights Toggle  . . . . . . . . . . . . . . .  35
  196.                [Alt-U]   Utility Menu . . . . . . . . . . . . . . . . .  36
  197.                [Alt-W]   Send Current Password  . . . . . . . . . . . .  36
  198.                [Alt-X]   Exit from {COMMO}  . . . . . . . . . . . . . .  36
  199.                [Alt-1]   Capture File Options . . . . . . . . . . . . .  37
  200.                [Alt-2]   Print Log Toggle . . . . . . . . . . . . . . .  38
  201.                [Alt--]   Chat Mode Toggle  (Alt minus)  . . . . . . . .  38
  202.                [Alt-=]   Doorway Mode Toggle  . . . . . . . . . . . . .  39
  203.                [F1]   How to Use Online Help  . . . . . . . . . . . . .  40
  204.                     Modifying the Help File . . . . . . . . . . . . . .  40
  205.  
  206.  
  207.  
  208.                    {COMMO} (tm)  User Guide and Reference          page iii
  209.  
  210.  
  211.  
  212.           [PgUp]/[PgDn]  Uploading/Downloading  . . . . . . . . . . . .  41
  213.                How to Install External Protocol Drivers . . . . . . . .  41
  214.                Using DSZ or GSZ . . . . . . . . . . . . . . . . . . . .  42
  215.                Using OZBEXT . . . . . . . . . . . . . . . . . . . . . .  43
  216.                {COMMO} Auto Receive . . . . . . . . . . . . . . . . . .  43
  217.  
  218.           Appendix A   Setting Up Your Modem  . . . . . . . . . . . . .  45
  219.                Answering a call from another computer . . . . . . . . .  47
  220.                Connecting two computers (null modem cable)  . . . . . .  47
  221.  
  222.           Appendix B   {COMMO} and Multi-Tasking  . . . . . . . . . . .  48
  223.                DESQview . . . . . . . . . . . . . . . . . . . . . . . .  48
  224.                OmniView . . . . . . . . . . . . . . . . . . . . . . . .  49
  225.                DoubleDOS  . . . . . . . . . . . . . . . . . . . . . . .  49
  226.  
  227.           Appendix C   Flow Control . . . . . . . . . . . . . . . . . .  50
  228.  
  229.           Appendix D   ASCII Character Representation . . . . . . . . .  51
  230.  
  231.           Appendix E   Terminal Emulation . . . . . . . . . . . . . . .  52
  232.                Printer Support  . . . . . . . . . . . . . . . . . . . .  53
  233.                ANSI-BBS Keyboard Support  . . . . . . . . . . . . . . .  53
  234.                VT102 Keyboard Simulation  . . . . . . . . . . . . . . .  54
  235.  
  236.           Appendix F   Usage Log Format . . . . . . . . . . . . . . . .  55
  237.  
  238.           Appendix G   Error Message Explanations . . . . . . . . . . .  56
  239.  
  240.  
  241.  
  242.                    {COMMO} (tm)  User Guide and Reference           page iv
  243.  
  244.  
  245.        =======
  246.        Preface
  247.        =======
  248.  
  249.        {COMMO} is a general purpose telecommunications program, also called
  250.        a "terminal" program.  Use it to dial remote systems and to
  251.        communicate using a choice of terminal emulations.  Many features
  252.        are available to enhance your communications needs.
  253.  
  254.        Minimum system configuration:
  255.  
  256.           IBM PC compatible computer.
  257.           MS-DOS 2.1 or higher.
  258.           128k of memory.
  259.           One diskette drive.
  260.           A serial port or internal modem with an 8250, 16450 or 16550
  261.           series UART chip.
  262.  
  263.        {COMMO} can be configured to work with virtually any type of modem.
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.  
  279.        DESQview is a trademark of Quarterdeck Office Systems
  280.        OmniView is a trademark of Sunny Hill Software
  281.        DoubleDOS is a trademark of SoftLogic Solutions, Inc.
  282.        HS/Link is a product of Samuel H. Smith
  283.        DSZ and GSZ are products of Omen Technology Inc.
  284.        MPt is a product of Matthew Thomas
  285.        LIST is a product of Vernon D. Buerg
  286.        The IBM PC is a product of IBM Corp.
  287.        MS-DOS is a trademark of MicroSoft Corp.
  288.  
  289.  
  290.  
  291.                    {COMMO} (tm)  User Guide and Reference           page 1
  292.  
  293.  
  294.        ==================
  295.        Principal Features
  296.        ==================
  297.  
  298.        {COMMO} is small in size, loads rapidly and performs all functions
  299.        with great speed.
  300.  
  301.        The powerful Macro Processor allows you to:
  302.  
  303.           1)   Write macro "scripts" to automate many common operations
  304.                such as logging in, reading messages, uploading/downloading. 
  305.                {COMMO} will perform these tasks in the middle of the night
  306.                while you sleep.
  307.  
  308.           2)   Assign Function Keys, Alt Keys, Keypad Keys, etc., to:
  309.  
  310.                     (a) send a string to the modem
  311.                     (b) execute any DOS command
  312.                     (c) start any macro
  313.                     (d) initiate any {COMMO} function.
  314.  
  315.           3)   Edit all macros without exiting {COMMO}, using the Internal
  316.                Editor.  Macros become effective immediately.
  317.  
  318.           4)   Call your computer from a remote location using {COMMO}'s
  319.                convenient Host Mode, written in {COMMO}'s macro language.
  320.  
  321.        The free-form Dialing Directory has space for hundreds of entries. 
  322.        Multi Number Dialing is supported from the command line.  AutoBaud
  323.        detect adjusts to the speed of the connection.  A macro may be
  324.        linked to each directory entry.
  325.  
  326.        Multi-tasking support.  {COMMO} is fully DESQview aware, operates in
  327.        far less memory than comparable programs.  Also supports OmniView,
  328.        DoubleDOS and others.
  329.  
  330.        Built-in ANSI-BBS and VT102 emulation.  Supports ANSI editing
  331.        functions, scrolling region, graphics character set, tab set/clear,
  332.        printing, modes, reports, etc.  Complete auto-switching VT102
  333.        keyboard support via Macro Processor.
  334.  
  335.        ENQ/ACK terminal protocol support.
  336.  
  337.        Built-in Xmodem and Xmodem-1k (old Ymodem) protocols.
  338.  
  339.        ASCII Upload to send messages and text files.  Features line pacing
  340.        and blank line expansion.
  341.  
  342.        The Setup File, Dialing Directory and Macro File may be edited with
  343.        the full-function Internal Editor.  String search is available in
  344.        all file windows.  Most features are fully configurable.
  345.  
  346.  
  347.  
  348.                    {COMMO} (tm)  User Guide and Reference           page 2
  349.  
  350.  
  351.        Any file up to 64k in size may be edited within {COMMO} using the
  352.        Internal Editor.
  353.  
  354.        {COMMO} supports all text display modes, including 132 column
  355.        screens.
  356.  
  357.        Split-screen Chat Mode for communicating with another computer which
  358.        is also running a terminal program.  All program features are
  359.        available while in Chat Mode.
  360.  
  361.        Doorway Mode lets you operate remote applications with full use of
  362.        your screen and keyboard.
  363.  
  364.        {COMMO}'s Auto Receive feature lets you configure any eight strings
  365.        to automatically trigger any eight macros.  Thus any protocol with a
  366.        "signature" can be set to start automatically.  Zmodem, HS/Link and
  367.        MPt are pre-configured.
  368.  
  369.        Support for any four serial ports.  Port addresses and IRQ's are
  370.        configurable.  Port speeds up to 115,200 bps (hardware dependent). 
  371.        Automatic support for NS16550A (or AF) buffered UART chip.
  372.  
  373.        Serial port signal lights may be displayed on the status line,
  374.        including send and receive.  Very useful with internal modems.
  375.  
  376.        Scrollback buffer up to 64k bytes gives instant replay of the text
  377.        that has scrolled off the screen.
  378.  
  379.        Capture Log saves all text from the screen to a disk file.  Three
  380.        different capture modes are available.
  381.  
  382.        Screen Image Save writes the current screen to a disk file.
  383.  
  384.        Print Log writes all text from the screen to the printer.
  385.  
  386.        Usage Log records date, time, length of call and other information
  387.        about each call.  Date of last call can be saved in the Dialing
  388.        Directory.
  389.  
  390.        Support for visually impaired users with {COMMO}'s configurable
  391.        Speech Friendly Interface.
  392.  
  393.        Enhanced keyboard support.
  394.  
  395.        Extensive context-related Online Help.
  396.  
  397.  
  398.        And {COMMO} is elegant, easy to learn and fun to use!
  399.  
  400.  
  401.  
  402.                    {COMMO} (tm)  User Guide and Reference           page 3
  403.  
  404.  
  405.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  406.                     -------------------------------------
  407.                     The Best Way to Learn {COMMO} Quickly
  408.                     -------------------------------------
  409.                     !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  410.  
  411.  
  412.        1) Read the section "Getting Started" which will get you up and
  413.           running.
  414.  
  415.        2) Read Appendix A "Setting Up Your Modem" for some very important
  416.           instructions regarding your specific hardware.
  417.  
  418.        3) Read through the section "{COMMO} Key Commands" to familiarize
  419.           yourself with {COMMO}'s commands and features.
  420.  
  421.        4) Use Online Help as a reference while you use {COMMO}.
  422.  
  423.  
  424.        How is it pronounced???  Just like "comma" (,) except for the last
  425.        letter.  It's technical jargon for "communications."
  426.  
  427.  
  428.        ===============
  429.        Getting Started
  430.        ===============
  431.  
  432.        NOTE:  Refer to Appendix G for explanations of any error messages
  433.        you receive during your initial use of {COMMO}.
  434.  
  435.        See the section "Preparing Your System" for more details on getting
  436.        started.
  437.  
  438.  
  439.        Quick Start Instructions
  440.        ========================
  441.  
  442.        1) If you have a hard drive, create a subdirectory named "COMMO." 
  443.           Copy all of the files from the {COMMO} archive or distribution
  444.           diskette into this subdirectory.
  445.  
  446.           If your system has only floppy drives, copy the {COMMO} files to
  447.           a formatted diskette.
  448.  
  449.           Now change to the {COMMO} subdirectory or log in to the diskette
  450.           where you have copied the {COMMO} files.
  451.  
  452.        2) Run the "New User's Guide"  by typing "guide" at the DOS prompt.
  453.           Follow the instructions carefully.  A macro will automatically
  454.           take you on a tour of some of {COMMO}'s main features.
  455.  
  456.  
  457.  
  458.                    {COMMO} (tm)  User Guide and Reference           page 4
  459.  
  460.  
  461.           When you are in the Setup File you will be in {COMMO}'s Internal
  462.           Editor and you may change any portion of the file using the arrow
  463.           keys, PgUp, PgDn and other editing keys.  Press Alt-E for Edit
  464.           Help to see a list of editing keys.
  465.  
  466.           You may need to change some of the items to conform to your
  467.           system setup.  Notice that {COMMO} only looks at the items that
  468.           are contained in curly braces: { }.  All other text is treated as
  469.           commentary and is not used by the program.
  470.  
  471.           Most items will not need to be changed until you are more
  472.           familiar with {COMMO}.  For now, check the following:
  473.  
  474.                The Default Dialing Parameters in the first item.  Make sure
  475.                you have the correct port number (the third field).  If your
  476.                modem is on COM2, change it to "2", COM3 to "3", etc.  Using
  477.                COM2 it would look like this:  {2400,8n1,2,A,0}.
  478.  
  479.                The Modem Initialization String.  If you know the commands
  480.                for your own modem, make the necessary adjustments.  If you
  481.                don't, then leave it like it is.  Refer to Appendix A for
  482.                more information.
  483.  
  484.                The items under "Paths and Files" (page down to see these). 
  485.  
  486.           Press [Esc] to save the file and continue the tour.
  487.  
  488.        3) The next stop is the Dialing Directory.  To alter an entry or to
  489.           add new ones, just press "E" to enter edit mode.  This is the
  490.           same Internal Editor you used to modify the Setup File.  When you
  491.           are finished making changes, press Esc to bring back the Selector
  492.           Bar.  Then press Esc again to continue.
  493.  
  494.        4) Next you will see a sample menu created by the Macro Processor. 
  495.           Press Enter to continue and return to the Terminal Screen.  Then
  496.           exit {COMMO} with the Alt-X command.
  497.  
  498.        5) From the DOS prompt type "commo<cr>" to restart the program.  The
  499.           new Setup File items will now be in effect.
  500.  
  501.        6) IMPORTANT!  {COMMO}'s Auto Receive feature is set up to
  502.           automatically start the program DSZ.COM (from Omen Technology)
  503.           when the remote system sends a file using the Zmodem protocol.
  504.  
  505.           Do not request a file for downloading with Zmodem until you have
  506.           this program installed in a directory that is in your DOS path
  507.           (or in the current directory).  If "Bad command or filename" is
  508.           displayed by DOS, just keep pressing Ctrl-X until it stops.  This
  509.           message means you haven't installed DSZ properly.
  510.  
  511.  
  512.  
  513.                    {COMMO} (tm)  User Guide and Reference           page 5
  514.  
  515.  
  516.           If things happen too quickly to see what is happening, you can
  517.           use EXECute Preview Mode, which will allow you see the results of
  518.           the command execution.  Use Alt-T to toggle Preview Mode on/off.
  519.  
  520.           The same principle applies to any other protocol drivers that you
  521.           use, such as MPt, etc.  If you don't have an external protocol
  522.           driver installed, use the internal Xmodem protocol (use Xmodem-1k
  523.           whenever possible since it is much faster).
  524.  
  525.        7) When you see the Status Line at the bottom of the screen, you are
  526.           in the Terminal Screen.  Now you may press Alt-D to enter the
  527.           Dialing Directory.  Use the up and down arrow keys to select a
  528.           system to call and press Enter.  {COMMO} will begin dialing.
  529.  
  530.        8) When a connection is made with a remote system, {COMMO} will
  531.           return to the Terminal Screen where you may interact with the
  532.           remote.
  533.  
  534.           NOTE:  If your modem does not seem to operate properly (no
  535.           connection is made or the data is garbled), read Appendix A
  536.           "Setting Up Your Modem."  You may need to change the Modem
  537.           Initialization String in the Setup File.  If you change it, exit
  538.           and restart {COMMO} to send the new string.  Then try dialing
  539.           again.
  540.  
  541.  
  542.        Preparing Your System
  543.        =====================
  544.  
  545.        The following sections give startup instructions in greater detail.
  546.  
  547.        Make sure that all of the files from the {COMMO} package are in one
  548.        directory or on one diskette.  Four of these files are required to
  549.        run the {COMMO} program:
  550.  
  551.             COMMO.COM      the Program File
  552.             COMMO.SET      the Setup File
  553.             COMMO.FON      the Dialing Directory File
  554.             COMMO.MAC      the Macro File
  555.  
  556.        In addition, if Online Help is used (recommended):
  557.  
  558.             COMMO.HLP      the Online Help File
  559.  
  560.        There are two ways to make sure that {COMMO} will be able to find
  561.        all of its files.  The first method is the simplest and should be
  562.        used if you are not too familiar with DOS commands:
  563.  
  564.        1) Make sure you are logged into the directory or disk drive where
  565.           the files are located.  Then simply type "commo" at the DOS
  566.           prompt.  If your files are in the directory "C:\COMMO" you would
  567.           type:
  568.  
  569.  
  570.  
  571.                    {COMMO} (tm)  User Guide and Reference           page 6
  572.  
  573.  
  574.  
  575.                c:<cr>
  576.                cd \commo<cr>
  577.                commo<cr>
  578.  
  579.           (<cr> is the [Enter] or Return key)
  580.  
  581.           Or if the files are on a diskette in drive A you would type:
  582.  
  583.                a:<cr>
  584.                commo<cr>
  585.  
  586.           {COMMO} will remember where the files are, so you will be able to
  587.           change directory or drive later without concern.
  588.  
  589.        2) The second method is a little more advanced, but allows you to
  590.           run {COMMO} no matter what directory or drive you are currently
  591.           logged into:
  592.  
  593.           Use the SET command in DOS to store the {COMMO} path into the
  594.           "environment."  If you place this command in your AUTOEXEC.BAT
  595.           file you won't have to change directories or diskettes to run
  596.           {COMMO}.  If your files are in the directory "C:\COMMO" the
  597.           command would be:
  598.  
  599.                set commo=c:\commo
  600.  
  601.           If the files are on the diskette in drive B the command would be:
  602.  
  603.                set commo=b:
  604.  
  605.           Do not use any extra spaces in the SET command.  And remember to
  606.           place the {COMMO} directory or drive in your PATH command.
  607.  
  608.           IMPORTANT!  Be sure to check your "set commo=" command if you
  609.           install {COMMO} into a different directory or onto another drive
  610.           (or if you install a later release of the program).  If it points
  611.           to the wrong directory, {COMMO} will not operate properly.  This
  612.           is a common error and can cause a lot of head scratching.
  613.  
  614.  
  615.  
  616.                    {COMMO} (tm)  User Guide and Reference           page 7
  617.  
  618.  
  619.        Command Line Options
  620.        ====================
  621.  
  622.           _______________
  623.  
  624.           Dialing Strings
  625.           _______________
  626.  
  627.        Dialing Strings are used to indicate numbers to dial at program
  628.        startup.  If present, they must be placed before any command line
  629.        switches.  {COMMO} will search the Dialing Directory for each string
  630.        and mark the first entry where a match is found (case is ignored).
  631.  
  632.        The strings may consist of any part of a Dialing Directory entry
  633.        line (usually part of the system name) and may be separated by
  634.        commas or spaces.  The following characters may not appear in a
  635.        command line Dialing String: space, comma, slash (/), curly braces.
  636.  
  637.        After entries in the Dialing Directory are marked, {COMMO} will
  638.        check for a startup macro (specified on the command line or in the
  639.        Setup File).  If a startup macro is present, it will be started. 
  640.        Otherwise Multi Number Dialing of the marked systems will begin.
  641.  
  642.        Examples:
  643.  
  644.                 commo telegodzilla joes-bbs 4567 
  645.  
  646.                 commo zilla,joes,4567
  647.  
  648.        IMPORTANT!  The Modem Initialization String will normally be sent
  649.        before dialing begins.  Your modem should be turned on and ready to
  650.        receive the command string before you start {COMMO}.
  651.  
  652.           ________
  653.  
  654.           Switches
  655.           ________
  656.  
  657.        Case is ignored and the switches may be in any order (Dialing
  658.        Strings must precede them, however).
  659.  
  660.          /:label         Startup Macro.
  661.  
  662.        This switch can be used to override the "mac=" item in the Setup
  663.        File.  The "label" is a one to eight character macro label.  If the
  664.        label is found in the Macro File, macro processing will be started. 
  665.        If the label is not found the switch will be ignored.
  666.  
  667.          /sfilename      Alternate Setup File.  
  668.          /dfilename      Alternate Dialing Directory File.
  669.          /mfilename      Alternate Macro File
  670.  
  671.  
  672.  
  673.                    {COMMO} (tm)  User Guide and Reference           page 8
  674.  
  675.  
  676.        Only the filename should be specified.  The {COMMO} home directory
  677.        will be assumed for the path.
  678.  
  679.        If an alternate Macro File is specified, it will become the default
  680.        Macro File.  This means it will be reloaded when the "R" switch is
  681.        used with the MACLoad macro function.
  682.  
  683.          /knn            Scrollback Buffer size.
  684.  
  685.        This switch will override the "sbs=" item in the Setup File.  "nn"
  686.        is kilobytes and may be 0 to 64.
  687.  
  688.          /i[y/n]         Modem Initialization override.
  689.  
  690.        Forces the Modem Initialization String to be sent ("/iy") or not
  691.        sent ("/in").  This will override the "min=" item in the Setup File.
  692.  
  693.        Example:
  694.  
  695.        C:\COMMO> commo joes zilla /:mailrun /dother.dir /k25 /in
  696.  
  697.           Two systems will be marked in the Dialing Directory.
  698.  
  699.           The macro "mailrun" will be started if it exists in the Macro
  700.           File.
  701.  
  702.           The alternate Dialing Directory "other.dir" will be loaded.
  703.  
  704.           The Scrollback Buffer will be set to 25k in size.
  705.  
  706.           The Modem Initialization String will not be sent.
  707.  
  708.  
  709.        {COMMO} Support Files
  710.        =====================
  711.  
  712.        The {COMMO} files are standard ASCII text files and may be modified
  713.        with any editor (or word processor in "non-document" mode).  From
  714.        within {COMMO} they may be edited with {COMMO}'s Internal Editor.
  715.  
  716.        The only control characters (below ASCII 28) allowed in the support
  717.        files are CR/LF pairs and an EOF at the end.  {COMMO}'s Internal
  718.        Editor adheres to this rule.  Control characters may be represented
  719.        as shown in Appendix D.  For example, an ASCII 16 would be written
  720.        as ^P.
  721.  
  722.        Key definitions for the Internal Editor are given in Online Help.  A
  723.        Color Chart will be displayed in the editor when F7 is pressed
  724.        (useful in the Setup File and for the DISPlay function in the Macro
  725.        File).
  726.  
  727.  
  728.  
  729.                    {COMMO} (tm)  User Guide and Reference           page 9
  730.  
  731.  
  732.        NOTE:  {COMMO} generally retains the Dialing Directory and Macro
  733.        File in memory during program operation.  If you use an external
  734.        editor to modify them while in the Shell to DOS (or using the EXEC
  735.        macro function), your changes could be lost.  See "Saving the
  736.        Support Files" below.
  737.  
  738.        Following is a brief description of each file. 
  739.  
  740.        1) COMMO.SET.  The Setup File contains settings for many important
  741.           parameters.  The first time you run {COMMO} you should use the
  742.           Alt-G key command to edit this file to your own needs.  See
  743.           "Alt-G  Edit Setup File" for details on each item.
  744.  
  745.        2) COMMO.FON.  The Dialing Directory File.  This file contains
  746.           information about each system that you will be calling, including
  747.           the telephone number, password, Linked Macro and serial port
  748.           parameter overrides.  Use the Alt-D key command to dial numbers
  749.           and to edit this file.  Details are given in the section "Alt-D 
  750.           Dialing Directory."
  751.  
  752.        3) COMMO.MAC.  The Macro File.  Use the Alt-M key command to select
  753.           a macro for execution and to edit this file.  A complete
  754.           description of {COMMO} macros is given in the Macro Programming
  755.           Guide, MACRO.DOC .  A summary of macro functions and key
  756.           designators is also given in Online Help.
  757.  
  758.        4) COMMO.HLP.  The Online Help File.  This file contains the
  759.           information for {COMMO}'s context-related Online Help.  See "How
  760.           to Use Online Help" later in this document.
  761.  
  762.  
  763.        Saving the Support Files
  764.        ========================
  765.  
  766.        Whenever a change is made to any file, the internal change flag is
  767.        set for that file (indicated by an "*" next to the column number in
  768.        the Internal Editor).
  769.  
  770.        The Dialing Directory and Macro File will be saved automatically
  771.        when you exit {COMMO} (if the change flag is set).  The Setup File
  772.        and other files that you may edit will be saved when you press Esc
  773.        to exit the editor.
  774.  
  775.        You may press Alt-F in the Internal Editor to immediately save any
  776.        file.
  777.  
  778.        If you do not wish to save your changes to the Dialing Directory or
  779.        Macro File, you may press Alt-Q while in the Internal Editor.  This
  780.        will reset {COMMO}'s change flag and the file will not be saved when
  781.        exiting the program.  Any subsequent changes to the file will set
  782.        the change flag again.
  783.  
  784.  
  785.  
  786.                    {COMMO} (tm)  User Guide and Reference           page 10
  787.  
  788.  
  789.        Pressing Alt-Q while editing any other file will cancel the edit.
  790.  
  791.  
  792.        Initialization Procedure
  793.        ========================
  794.  
  795.        When {COMMO} begins running it will read and process the Setup File. 
  796.        Then it will attempt to load into memory:
  797.  
  798.           (1) the Dialing Directory     COMMO.FON
  799.           (2) the Macro File            COMMO.MAC
  800.  
  801.        Any problems encountered will be reported.  These problems must be
  802.        corrected before restarting the program.
  803.  
  804.        Automatic modem initialization will occur if requested in the Setup
  805.        File with {min=yes}, or by the "/iy" command line switch.  Use the
  806.        "/in" switch to suppress modem initialization if you are already on
  807.        line.
  808.  
  809.        Please note that {COMMO} does NOT change the video display mode. 
  810.        Instead {COMMO} can adapt to any text mode that is set when the
  811.        program is started.  Check the items under "Video and Chat Mode" in
  812.        the Setup File for details.  See also the section "[Alt-G]  Edit
  813.        Setup File" later in this document.
  814.  
  815.        If the display does not look right try executing the DOS command 
  816.        "mode co80" or "mode bw80" prior to calling {COMMO}.
  817.  
  818.  
  819.        Terminal Screen
  820.        ===============
  821.  
  822.        The Terminal Screen allows you to see the characters coming in from
  823.        the serial port.  Any characters that you type will be sent out to
  824.        the serial port.  If you are connected to another system you will be
  825.        interacting with that system.
  826.  
  827.        Keep in mind that you will also be interacting with {COMMO} and with
  828.        your own computer via key commands (Alt keys, for example).  These
  829.        key commands have no effect on the remote system unless they cause
  830.        characters to be sent to the serial port (pressing Alt-W to send
  831.        your password, for example).
  832.  
  833.  
  834.  
  835.                    {COMMO} (tm)  User Guide and Reference           page 11
  836.  
  837.  
  838.        ====================
  839.        {COMMO} Key Commands
  840.        ====================
  841.  
  842.        The Alt Keys shown in this section are the built-in default key
  843.        assignments for the various {COMMO} commands.  Once you are familiar
  844.        with these commands you may use the Macro Processor to reassign any
  845.        of the keys.
  846.  
  847.        Keys used within the various command windows are properly detailed
  848.        in Online Help.  Please press F1 from any command window to invoke
  849.        {COMMO}'s context-related help system.
  850.  
  851.        Note that certain features are only available as macro functions. 
  852.        Refer to MACRO.DOC for details.
  853.  
  854.  
  855.        ======================
  856.        [Alt-A]   ASCII Upload
  857.        ======================
  858.  
  859.        This command is used to send prepared messages or any text files to
  860.        the remote system.  Enter the pathname of the file you wish to send. 
  861.        Note that the input field will be blank unless a macro is used to
  862.        prompt with a path.  The macro supplied in COMMO.MAC is:
  863.  
  864.           {:ala} {ascii %uldir\} {}          ASCII Upload with path
  865.  
  866.        Notice the "\" following the path variable.  It tells {COMMO} to
  867.        prompt for the filename.  If you needed to specify a colon for
  868.        pacing (see below) you could change this to:
  869.  
  870.           {:ala} {ascii %uldir\,:} {}        ASCII Upload with path
  871.  
  872.        There is no special error checking associated with ASCII Upload.  It
  873.        is intended primarily for sending message responses and other short
  874.        text files.  For longer files, binary files or compressed files
  875.        (.ARC, .ZIP) you will want to use error checking protocols such as
  876.        Xmodem, Zmodem, MPt, etc.  See "Uploading / Downloading."
  877.  
  878.        A number of parameters are used to control an ASCII Upload:
  879.  
  880.           ___________
  881.  
  882.           Line Pacing
  883.           ___________
  884.  
  885.        IMPORTANT!  Line Pacing is used to keep transmitted data
  886.        synchronized with received (echoed) data and is normally used ONLY
  887.        when the remote is sending a prompt for each line, usually "nn:" or
  888.        "nn?".  "nn" is a line number and ":" or "?" is the prompt or
  889.        "pacing character."
  890.  
  891.  
  892.  
  893.                    {COMMO} (tm)  User Guide and Reference           page 12
  894.  
  895.  
  896.  
  897.        {COMMO} will wait up to 5 seconds for the pacing character, then
  898.        send the next line.  If there is a 5 second delay between the
  899.        sending of each line, then either you have the wrong pacing
  900.        character or you don't need line pacing (you don't need it when
  901.        using a full-screen editor, for example).
  902.  
  903.        At any time, the Spacebar may be pressed to force transmission of
  904.        the next line.  This is very useful when you have set the wrong
  905.        pacing character or if you wish to send each line manually.  In the
  906.        latter case, use any pacing character that is different from the one
  907.        in the line prompt.
  908.  
  909.        To use line pacing, enter the pacing character when {COMMO} asks for
  910.        it in the ASCII Upload window.  
  911.  
  912.        The initial pacing character is configurable.  See "[Alt-G]  Edit
  913.        Setup File."
  914.  
  915.        The pacing character may be any character including control
  916.        characters, e.g. "^m" or "|" for carriage return.  See Appendix D
  917.        for details on how to represent special characters.
  918.  
  919.        See also Appendix C "Flow Control."
  920.  
  921.           ________________
  922.  
  923.           Character Pacing
  924.           ________________
  925.  
  926.        You may insert a delay between each character using the Inter-
  927.        Character Delay feature.  This should only be used when the remote
  928.        is so slow that it drops characters.  See "Set Terminal Parameters"
  929.        for details.
  930.  
  931.           ___________________
  932.  
  933.           Stripping Linefeeds
  934.           ___________________
  935.  
  936.        Normally you will want to strip linefeeds from your outgoing text. 
  937.        This will appear to the remote as if you are typing the data.  But
  938.        if all your data displays on the same line at the remote, then you
  939.        must configure {COMMO} to send the linefeeds.
  940.  
  941.        NOTE:  This item is initialized in the Setup File.
  942.  
  943.  
  944.  
  945.                    {COMMO} (tm)  User Guide and Reference           page 13
  946.  
  947.  
  948.           _____________________
  949.  
  950.           Expanding Blank Lines
  951.           _____________________
  952.  
  953.        You may configure {COMMO} to send a space character whenever a blank
  954.        line is encountered in the text file you are sending.  This will
  955.        prevent your message from terminating prematurely if you are sending
  956.        to a BBS message editor.  Blank line expansion is not normally
  957.        required when sending to a "full screen" BBS editor.
  958.  
  959.        NOTE:  This item is initialized in the Setup File.
  960.  
  961.  
  962.        ===========================
  963.        [Alt-B]   Send Break Signal
  964.        ===========================
  965.  
  966.        A one second Break Signal will be sent.  This signal is used by some
  967.        systems to interrupt certain operations.  Use it only when the
  968.        remote system directs you to do so.
  969.  
  970.  
  971.        ======================
  972.        [Alt-C]   Clear Screen
  973.        ======================
  974.  
  975.        The Terminal Screen will be cleared and the current colors will be
  976.        set to the Setup File defaults.
  977.  
  978.  
  979.        ===========================
  980.        [Alt-D]   Dialing Directory
  981.        ===========================
  982.  
  983.        The Dialing Directory is your data base of telephone numbers.  From
  984.        the directory window you can select numbers to dial and also update
  985.        the directory using the Internal Editor.
  986.  
  987.        Refer to Online Help for a complete description of the commands
  988.        available in the Dialing Directory window.
  989.  
  990.  
  991.  
  992.                    {COMMO} (tm)  User Guide and Reference           page 14
  993.  
  994.  
  995.        _______________________________
  996.  
  997.        Dialing Directory Entry Example
  998.        _______________________________
  999.  
  1000.  
  1001.          System       Telephone    System    Linked   Terminal    Last
  1002.          Name         Number       Password  Macro    Parameters  Called
  1003.        _____________  __________  _________  ______   __________  ______
  1004.  
  1005.        File City BBS  {555-1234}  {aardvark}  {city}     {}       05/20/90
  1006.  
  1007.        NOTE:  Any number of Variable Items may be added following the
  1008.        Terminal Parameters item (see below).
  1009.  
  1010.  
  1011.        IMPORTANT!  Items in curly braces must be present (they are
  1012.        positional).  Items which are not used must have a null string {} as
  1013.        a placeholder.  You may omit null strings at the end of the line.
  1014.  
  1015.        Directory entries are limited to one per line.  Lines may be up to
  1016.        255 characters in length ({COMMO}'s Internal Editor will scroll
  1017.        horizontally to follow the cursor).
  1018.  
  1019.        Comments may be placed anywhere outside the curly braces or on
  1020.        separate lines.
  1021.  
  1022.        ______________________________
  1023.  
  1024.        System Name      File City BBS
  1025.        ______________________________
  1026.  
  1027.           Up to 40 characters in length,  it must NOT be enclosed in curly
  1028.           braces.  The System Name will be displayed on the Status Line
  1029.           after connection, unless the Signal Lights option is selected. 
  1030.           It will also be part of a Usage Log entry if the log is enabled.
  1031.  
  1032.        ______________________________________
  1033.  
  1034.        Telephone Number      {1-707-555-1234}
  1035.        ______________________________________
  1036.  
  1037.           Spaces and hyphens are ignored by most modems.  The Dialing
  1038.           Prefix, Telephone Number and Dialing Suffix are strung together
  1039.           to form a dialing command (may be up to 128 characters total). 
  1040.           Refer to your modem manual for details on dialing commands.
  1041.  
  1042.           Normally the default Dialing Prefix (usually "ATDT") and the
  1043.           default Dialing Suffix (usually "|") will be used.  These are
  1044.           specified in the Setup File.  You may also have any number of
  1045.           alternate prefixes and suffixes by defining them with SET items
  1046.           in the Setup File.
  1047.  
  1048.  
  1049.  
  1050.                    {COMMO} (tm)  User Guide and Reference           page 15
  1051.  
  1052.  
  1053.  
  1054.           For example, if you wanted your prefix for a certain entry to be
  1055.           "ATM1L3DT" (to turn on the modem speaker LOUD), you could put
  1056.           this item in your Setup File:
  1057.  
  1058.                {set spkrpref,ATM1L3DT}       Loud speaker prefix
  1059.  
  1060.           Then your entry might look like this:
  1061.  
  1062.                File City  {%spkrpref%555-1234} {pword} {city} {}
  1063.  
  1064.           The prefix "spkrpref" will override the default prefix if it is
  1065.           at the very beginning of the telephone number field.  Similarly,
  1066.           an override suffix may be specified if it is at the very end of
  1067.           the field.
  1068.  
  1069.           Notice that these are variable names and must be bracketed
  1070.           between "%" characters.  Variables may be placed anywhere else
  1071.           within the number field as well, but they will not override the
  1072.           default prefix or suffix unless they are at the very beginning or
  1073.           very end, respectively.
  1074.  
  1075.           You may use variables defined with SET items in the Setup File or
  1076.           variables set within macros.
  1077.  
  1078.        _________________________________
  1079.  
  1080.        System Password      {mypassword}
  1081.        _________________________________
  1082.  
  1083.           A different Password String may be defined for each system that
  1084.           you call.  Passwords may be up to 64 characters in length.
  1085.  
  1086.           The Password String may be sent by pressing Alt-W or by using the
  1087.           variable "_pas" in a SEND macro function.
  1088.  
  1089.           Passwords are invisible in the Dialing Directory window, but
  1090.           appear when you enter [E]dit mode.
  1091.  
  1092.           Rules for writing passwords are in Appendix D.
  1093.  
  1094.        ________________________
  1095.  
  1096.        Linked Macro      {city}  
  1097.        ________________________
  1098.  
  1099.           If a valid Linked Macro is specified, it will be started when a
  1100.           connection is established with the remote system.  If no macro is
  1101.           specified (or the macro label is not found), {COMMO} will enter
  1102.           the Terminal Screen.
  1103.  
  1104.  
  1105.  
  1106.                    {COMMO} (tm)  User Guide and Reference           page 16
  1107.  
  1108.  
  1109.        ___________________________
  1110.  
  1111.        Terminal Parameters      {}
  1112.        ___________________________
  1113.  
  1114.           This item allows you to override any or all of the Dialing
  1115.           Default parameters for the current call.  Prior to dialing each
  1116.           number, {COMMO} will set all Terminal Parameters to the Dialing
  1117.           Defaults (Dialing Defaults are initialized in the Setup File, but
  1118.           may be changed with the DPARms macro function or with the Alt-P
  1119.           key command).
  1120.  
  1121.           If a system requires parameters that are different from the
  1122.           Dialing Defaults, specify them in this item.
  1123.  
  1124.           The general form of this item is:
  1125.  
  1126.                {speed,format,comport,terminal-type,delay}
  1127.  
  1128.           For example, you might have "{,7,,V}", which would set the Data
  1129.           Format to "7e1" and the Terminal-type to VT102, but would use the
  1130.           Dialing Defaults for the other parameters.
  1131.  
  1132.           See "Set Terminal Parameters" for a complete description of each
  1133.           field.  See also "AutoBaud Detect."
  1134.  
  1135.        _________________________
  1136.  
  1137.        Last Called      05/20/90
  1138.        _________________________
  1139.  
  1140.           If this item is present, {COMMO} will replace it with the current
  1141.           date whenever a connection is made with the system.  It may
  1142.           appear anywhere on the entry line (outside the curly braces). 
  1143.           Place "00/00/00" to start it.  The Dialing Directory file will be
  1144.           saved to disk when you exit {COMMO}.
  1145.  
  1146.  
  1147.        _________________________________
  1148.  
  1149.        Variable Items      {name,string}
  1150.        _________________________________
  1151.  
  1152.           Any number of Variable Items may be included in a directory entry
  1153.           and will be set just prior to dialing.  The "string" may not
  1154.           contain any variables.  The first Variable Item must follow the
  1155.           Terminal Parameters item (all other items must be present as
  1156.           placeholders even if some are null).  Example:
  1157.  
  1158.             Joes-BBS  {555-1234} {pword} {mac} {} {bbsid,joesbbs} ...
  1159.  
  1160.  
  1161.  
  1162.                    {COMMO} (tm)  User Guide and Reference           page 17
  1163.  
  1164.  
  1165.        See also "[Alt-N]  Multi Number Dialing."
  1166.  
  1167.  
  1168.        =========================
  1169.        [Alt-G]   Edit Setup File
  1170.        =========================
  1171.  
  1172.        Pressing Alt-G allows you to edit the Setup File (see "Internal
  1173.        Editor" in Online Help for details on editing).  The Setup File
  1174.        contains initial settings for many parameters used by {COMMO}.
  1175.  
  1176.        Items changed with the editor are not effective until the next time
  1177.        you start the program.  However, most items may be changed with key
  1178.        commands and/or macro functions while the program is running.
  1179.  
  1180.        Each item in the Setup File is enclosed in curly braces.  Items are
  1181.        designated with three letter "keywords" and may be present in any
  1182.        order.  There are no "required" items.  Missing items will take on
  1183.        the values shown in the examples below, except for SET items, which
  1184.        become null (0 characters) when they are missing.
  1185.  
  1186.        All text outside the curly braces is commentary and is ignored by
  1187.        {COMMO}.  Avoid using curly braces other than to bracket setup
  1188.        items.
  1189.  
  1190.  
  1191.        Predefining Variables with SET
  1192.        ==============================
  1193.  
  1194.        SET items predefine variables in {COMMO}'s String Variable Space. 
  1195.        The general form of a SET item is
  1196.  
  1197.           {set name,string}.
  1198.  
  1199.                name      Any valid variable name, either reserved or user-
  1200.                          defined.
  1201.  
  1202.                string    A text string to assign to the name.  The string
  1203.                          may not contain any variables.
  1204.  
  1205.        Any number of SET items may appear in the Setup File.  They may be
  1206.        used later in macros, in telephone numbers, etc.
  1207.  
  1208.        See MACRO.DOC for more information on variables.
  1209.  
  1210.  
  1211.  
  1212.                    {COMMO} (tm)  User Guide and Reference           page 18
  1213.  
  1214.  
  1215.        Explanation of Setup File Items
  1216.        ===============================
  1217.  
  1218.        ____________________________________________________________________
  1219.  
  1220.         {ddp=2400,8n1,1,A,0}       Default Dialing Parameters, set when you
  1221.                                    dial (speed,format,port,terminal,delay).
  1222.  
  1223.                                    These are also the current settings when
  1224.                                    you start the program.
  1225.        ____________________________________________________________________
  1226.  
  1227.           These values will be used as the current settings when {COMMO} is
  1228.           started and each time dialing begins.  Use the "Terminal
  1229.           Parameters" item in the Dialing Directory to set overrides when
  1230.           required.  Use Alt-P or the macro function DPARms to change
  1231.           dialing parameters at other times.
  1232.  
  1233.           See "Set Terminal Parameters" for a complete description of each
  1234.           field and how to change current parameters as well.
  1235.  
  1236.           NOTE:  PCjr users without the internal modem should specify Com2.
  1237.  
  1238.        _________________________________________________
  1239.  
  1240.         {min=yes}        Send Modem Init String (yes/no)
  1241.        _________________________________________________
  1242.  
  1243.           If "yes" this will instruct {COMMO} to send the Modem
  1244.           Initialization String at program startup.  You can override this
  1245.           item with the "/iy" or "/in" command line switch.
  1246.  
  1247.        ____________________________________________________
  1248.  
  1249.         {set _modini,~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  1250.  
  1251.                     Modem Init String (2400 bps and higher)
  1252.        ____________________________________________________
  1253.  
  1254.           This item defines the reserved variable "_modini" (notice that
  1255.           the string itself begins following the comma).
  1256.  
  1257.           The Modem Initialization String is normally sent to your modem
  1258.           when {COMMO} is started or when you press Alt-O.  
  1259.  
  1260.           If you are using a 1200 bps modem you should remove the "&C1 &D2"
  1261.           commands.  In either case the "X" command may have to be
  1262.           adjusted.  See Appendix A "Setting Up Your Modem."
  1263.  
  1264.  
  1265.  
  1266.                    {COMMO} (tm)  User Guide and Reference           page 19
  1267.  
  1268.  
  1269.        ___________________________________________________________
  1270.  
  1271.         {sfc=yes}        Software (XON/XOFF) Flow Control (yes/no)
  1272.         {hfc=no}         Hardware (RTS/CTS) Flow Control (yes/no)
  1273.        ___________________________________________________________
  1274.  
  1275.           These are used to control the flow of data between your computer
  1276.           and the remote system.  They prevent loss of data when one end
  1277.           can send faster than the other end can process the information. 
  1278.           See Appendix C for details.
  1279.  
  1280.        ___________________________________________________
  1281.  
  1282.         {dex=no}         Drop DTR and RTS on exit (yes/no)
  1283.        ___________________________________________________
  1284.  
  1285.           Leave this "no" if you want to exit {COMMO} and return while
  1286.           still connected to a host.  "Yes" will normally cause the modem
  1287.           to hang up when exiting.
  1288.  
  1289.        ______________________________________________
  1290.  
  1291.         {enq=no}         Answer ENQ with ACK (yes/no)
  1292.        ______________________________________________
  1293.  
  1294.           Some hosts send an ENQ control character (^E) periodically and
  1295.           require that the terminal "answer back" with an ACK (^F).  Set
  1296.           this item to "yes" only if your host requires this.
  1297.  
  1298.        ________________________________________________
  1299.  
  1300.         {aut=pzbr,^xB00}           Auto Receive, Zmodem
  1301.         {aut=phbr,^bR}             Auto Receive, HS/Link
  1302.         {aut=pmpr,^v^h^vMPt}       Auto Receive, MPt
  1303.        ________________________________________________
  1304.  
  1305.           The general form of this item is:  {aut=label,string}.  When the
  1306.           specified string (up to 32 characters, case ignored) is received,
  1307.           the macro will be started.
  1308.  
  1309.           These are normally used for automatically starting downloads, but
  1310.           may be used to trigger any macro upon receiving any string.
  1311.  
  1312.           Up to eight Auto Receive Strings may be specified.  Operates in
  1313.           Terminal Mode only (use GOLOok/LOOKfor in macros).
  1314.  
  1315.           See the section "{COMMO} Auto Receive" for more details.
  1316.  
  1317.  
  1318.  
  1319.                    {COMMO} (tm)  User Guide and Reference           page 20
  1320.  
  1321.  
  1322.        ____________________________________________
  1323.  
  1324.         {com=1,3f8,4}         Com1 port address/IRQ
  1325.         {com=2,2f8,3}         Com2 port address/IRQ
  1326.         {com=3,3e8,4}         Com3 port address/IRQ
  1327.         {com=4,2e8,3}         Com4 port address/IRQ
  1328.        ____________________________________________
  1329.  
  1330.           These are the hardware serial port base address and IRQ
  1331.           assignments.  The settings shown are the most common, but some
  1332.           serial adapters are different.  The serial adapter manual may
  1333.           give a range of addresses, for example "3f8-3ff."  Use the first
  1334.           value as the base address.
  1335.  
  1336.        _____________________________________________
  1337.  
  1338.         {abd=no}         AutoBaud Detect on (yes/no)
  1339.        _____________________________________________
  1340.  
  1341.           Determines the initial state of the AutoBaud toggle.  See
  1342.           "AutoBaud Detect" under "[Alt-T]  Set Toggles."
  1343.  
  1344.        ____________________________________________________________________
  1345.  
  1346.         {cdm=yes}        Clear dialing marks when saving directory (yes/no)
  1347.        ____________________________________________________________________
  1348.  
  1349.           If this is "yes", dialing marks will not be written to disk when
  1350.           saving the Dialing Directory file.  Set it to "no" if you wish
  1351.           the marks to be saved with the file (to be used in the next
  1352.           session).
  1353.  
  1354.           Note that changes to dialing marks (mark or unmark) will not
  1355.           cause the file to be saved upon exit from {COMMO}.  If no other
  1356.           changes occur (such as Date Last Called), you must use Alt-F in
  1357.           the Internal Editor to save the marks.
  1358.  
  1359.        __________________________________________________
  1360.  
  1361.         {set _dialpf,ATDT }        Default Dialing Prefix
  1362.         {set _dialsf, |}           Default Dialing Suffix
  1363.        __________________________________________________
  1364.  
  1365.           These reserved variables define strings that will be used to
  1366.           create the modem dialing command.  The prefix, telephone number
  1367.           and suffix will be strung together in that order and sent to your
  1368.           modem when you dial.
  1369.  
  1370.           Any number of additional prefixes and suffixes may be used by
  1371.           including variables in the telephone number string (see "[Alt-D] 
  1372.           Dialing Directory" for details).
  1373.  
  1374.  
  1375.  
  1376.                    {COMMO} (tm)  User Guide and Reference           page 21
  1377.  
  1378.  
  1379.           Use "ATDP" if you don't have a tone line.  Use "ATDT9," to get an
  1380.           outside line on a switchboard.  The suffix is usually just a
  1381.           carriage return (|).  Your modem manual has additional tips on
  1382.           dialing prefixes and suffixes.
  1383.  
  1384.        __________________________________________________
  1385.  
  1386.         {dct=45}         Dialing cycle time-out (seconds)
  1387.        __________________________________________________
  1388.  
  1389.           The maximum time to wait before hanging up and redialing.  Adjust
  1390.           if your modem needs more time to complete a call.
  1391.  
  1392.        __________________________________________________________
  1393.  
  1394.         {idt=2}          Delay between dialing attempts (seconds)
  1395.        __________________________________________________________
  1396.  
  1397.           Amount of time to wait between dialing attempts.  Adjust to give
  1398.           incoming calls a greater chance of getting through.
  1399.  
  1400.        ____________________________________________________________
  1401.  
  1402.         {set _dialsr,CONNECT}           Dialing success response(s)
  1403.         {set _dialfr,BUSY,NO CARRIER,NO DIALTONE}
  1404.                                         Dialing failure response(s) 
  1405.        ____________________________________________________________
  1406.  
  1407.           These reserved variables each define a list of response codes
  1408.           that can be found in your modem manual.  Do not include the speed
  1409.           in the CONNECT response if you are enabling AutoBaud.
  1410.  
  1411.           Some modems use a CARRIER response to indicate the modem speed,
  1412.           e.g. CARRIER 2400.  Using this instead of CONNECT will improve
  1413.           the accuracy of the Usage Log.  In order to avoid confusion with
  1414.           a NO CARRIER response, you should use:
  1415.  
  1416.                {set _dialsr,CARRIER }   Notice the space after CARRIER.
  1417.  
  1418.           Responses are case sensitive.  There should be no null strings or
  1419.           extra spaces.
  1420.  
  1421.        ___________________________________________________
  1422.  
  1423.         {set uldir,c:\commo}       Path to find uploads
  1424.         {set dldir,c:\commo}       Path to place downloads
  1425.        ___________________________________________________
  1426.  
  1427.           These variables are used in some of the macros in COMMO.MAC and
  1428.           SAMPLES.MAC, primarily in the Uploading and Downloading macros. 
  1429.           They are not reserved variables so you may change their names.
  1430.  
  1431.  
  1432.  
  1433.                    {COMMO} (tm)  User Guide and Reference           page 22
  1434.  
  1435.  
  1436.        __________________________________________________________________
  1437.  
  1438.         {set dszprog,DSZ.COM}      Name of program in DSZ family that you
  1439.                                    have (DSZ.COM, GSZ.EXE or DSZ.EXE)
  1440.        __________________________________________________________________
  1441.  
  1442.           This variable is used in macros that require an Omen Technology
  1443.           external protocol driver program.  Just enter one of the three
  1444.           programs shown and all of the Zmodem and Ymodem macros will use
  1445.           it (including the MOSTHOST).
  1446.  
  1447.        ____________________________________________________________
  1448.  
  1449.         {set _uselog,c:\commo\commo.log}     Pathname for Usage Log
  1450.        ____________________________________________________________
  1451.  
  1452.           This is a reserved variable that tells {COMMO} where to find your
  1453.           Usage Log.  The Usage Log keeps a record of the calls you make. 
  1454.           If a valid pathname is specified, entries will be made when:
  1455.  
  1456.                1) You connect to a system.
  1457.                2) You transfer a file using an internal protocol.
  1458.                3) You disconnect (or exit {COMMO}).
  1459.  
  1460.           IMPORTANT!  In order for the log to function properly your modem
  1461.           must be set to provide "true carrier detect" (see Appendix A).
  1462.  
  1463.           Use a null pathname or remove this item to disable the Usage Log. 
  1464.           A null pathname would look like this:
  1465.  
  1466.                {set _uselog}
  1467.  
  1468.           The Usage Log should be disabled when you are connecting directly
  1469.           to another computer (with a null modem cable).
  1470.  
  1471.           Specify the same log file as your external protocol driver (e.g.,
  1472.           DSZ.LOG or MPT.LOG) and you will have a complete record of your
  1473.           calls, including upload/download statistics.
  1474.  
  1475.           If a filename only (no path) is specified, the current directory
  1476.           will be used.  The pathname of an open Capture File is not
  1477.           allowed.
  1478.  
  1479.           See also Appendix F "Usage Log Format."
  1480.  
  1481.  
  1482.  
  1483.                    {COMMO} (tm)  User Guide and Reference           page 23
  1484.  
  1485.  
  1486.        __________________________________________________________
  1487.  
  1488.         {cap=c:\commo\commo.cap}        Pathname for Capture File
  1489.        __________________________________________________________
  1490.  
  1491.           This is the initial setting for the Capture File pathname.  It
  1492.           may be changed later with the Alt-1 key command or with the
  1493.           CAPTure macro function (do not try to change the "_cap" built-in
  1494.           variable with SETV).
  1495.  
  1496.           If a filename only (no path) is specified, the current directory
  1497.           will be used.
  1498.  
  1499.           See also "Capture File Options."
  1500.  
  1501.        _______________________________________________________________
  1502.  
  1503.         {scr=c:\commo\commo.scr}        Pathname for Screen Image File
  1504.        _______________________________________________________________
  1505.  
  1506.           This is the initial setting for the Screen Image File pathname. 
  1507.           It may be changed later with the Alt-I key command, with the
  1508.           SCREen macro function, or from within the Scrollback Buffer
  1509.           window (do not try to change the "_scr" built-in variable with
  1510.           SETV).
  1511.  
  1512.           If a filename only (no path) is specified, the current directory
  1513.           will be used.  The pathname of an open Capture File is not
  1514.           allowed.
  1515.  
  1516.           See also "Screen Image Save" and "Scrollback"
  1517.  
  1518.        ___________________________________________________
  1519.  
  1520.         {ebl=yes}        Expand blank lines (yes/no)
  1521.         {slf=yes}        Strip outgoing linefeeds (yes/no)
  1522.         {pac=}           ASCII Upload pacing character
  1523.        ___________________________________________________
  1524.  
  1525.           These items are used with the ASCII Upload feature.
  1526.  
  1527.           Blank line expansion sends a space and a carriage return, instead
  1528.           of just a carriage return for lines with no data.  This prevents
  1529.           BBS line editors from terminating prematurely.
  1530.  
  1531.           Stripping linefeeds gives the data the appearance of being
  1532.           entered manually.  Linefeeds should not be stripped when the
  1533.           remote is not in "edit" mode.
  1534.  
  1535.           The pacing character shown is null (no pacing).  To use a ":" for
  1536.           pacing, change the item to
  1537.  
  1538.  
  1539.  
  1540.                    {COMMO} (tm)  User Guide and Reference           page 24
  1541.  
  1542.  
  1543.                {pac=:}
  1544.  
  1545.           See "ASCII Upload" for more details.
  1546.  
  1547.        _____________________________________
  1548.  
  1549.         {mac=}           Startup macro label
  1550.        _____________________________________
  1551.  
  1552.           This item indicates a macro to run when {COMMO} starts up.  The
  1553.           command line switch "/:" can be used to override it.  See
  1554.           "Command Line Options."
  1555.  
  1556.           Example:  {mac=begin}.
  1557.  
  1558.        __________________________________________________
  1559.  
  1560.         {edd=no}         Enter Dialing Directory (yes/no)
  1561.        __________________________________________________
  1562.  
  1563.           If this is set to "yes" the Dialing Directory will be entered
  1564.           when {COMMO} is started (if no Dialing Strings or Startup Macro
  1565.           are present on the command line).
  1566.  
  1567.        ________________________________________
  1568.  
  1569.         {loc=no}         Local Echo on (yes/no)
  1570.        ________________________________________
  1571.  
  1572.           If this is set to "yes" Local Echo will be on when {COMMO} is
  1573.           started.
  1574.  
  1575.        _________________________________________
  1576.  
  1577.         {sts=yes}        Status Line on (yes/no)
  1578.        _________________________________________
  1579.  
  1580.           If this is set to "yes" the Status Line will be on when {COMMO}
  1581.           is started.
  1582.  
  1583.        ___________________________________________
  1584.  
  1585.         {sig=no}         Signal Lights on (yes/no)
  1586.        ___________________________________________
  1587.  
  1588.           If this is set to "yes" Signal Lights will be on when {COMMO} is
  1589.           started.
  1590.  
  1591.  
  1592.  
  1593.                    {COMMO} (tm)  User Guide and Reference           page 25
  1594.  
  1595.  
  1596.        ____________________________________________
  1597.  
  1598.         {cpf=no}         Capture File open (yes/no)
  1599.        ____________________________________________
  1600.  
  1601.           If this is set to "yes" Capture will be open when {COMMO} is
  1602.           started.  See "Capture File Options."
  1603.  
  1604.        _______________________________________________________
  1605.  
  1606.         {cpm=screen}          Capture Mode (screen/filter/raw)
  1607.        _______________________________________________________
  1608.  
  1609.           See "Capture File Options" for a description of each mode.
  1610.  
  1611.        _____________________________________________________
  1612.  
  1613.         {tek=no}         Test for enhanced keyboard (yes/no)
  1614.        _____________________________________________________
  1615.  
  1616.           Set this to "yes" if your system supports the enhanced (101 key)
  1617.           keyboard.  This will enable you to assign F11, F12 and a number
  1618.           of other keys to your macros.  See Appendix A "Table of {COMMO}
  1619.           Key-labels" in MACRO.DOC.
  1620.  
  1621.        _______________________________________________________________
  1622.  
  1623.         {tsn=yes}        Display time of day with System Name (yes/no)
  1624.        _______________________________________________________________
  1625.  
  1626.           If this is "yes" the time of day will be displayed on the right
  1627.           side of the Status Line.  Set this to "no" if you want the System
  1628.           Name given more space.  Note that this has no effect when the
  1629.           Signal Lights are displayed.
  1630.  
  1631.        __________________________________________
  1632.  
  1633.         {snd=yes}        Master Sound on (yes/no)
  1634.        __________________________________________
  1635.  
  1636.           If this is set to "yes" sound will be on when {COMMO} is started. 
  1637.           If "no" all sounds will be silenced. 
  1638.  
  1639.        ___________________________________________________
  1640.  
  1641.         {dca=yes}        Dialing connection alarm (yes/no)
  1642.        ___________________________________________________
  1643.  
  1644.           Controls the alarm that signals a connection when Auto Dialing is
  1645.           used.  The alarm will not be sounded when a valid Linked Macro is
  1646.           specified in the Dialing Directory.
  1647.  
  1648.  
  1649.  
  1650.                    {COMMO} (tm)  User Guide and Reference           page 26
  1651.  
  1652.  
  1653.        ______________________________________________________
  1654.  
  1655.         {afa=yes}        ASCII Upload finished alarm (yes/no)
  1656.        ______________________________________________________
  1657.  
  1658.           Controls the alarm that signals completion of an ASCII Upload.
  1659.  
  1660.        _________________________________________________________
  1661.  
  1662.         {ers=yes}        Make sounds on errors/warnings (yes/no)
  1663.        _________________________________________________________
  1664.  
  1665.           This controls the special sounds made for certain errors and
  1666.           warning messages.
  1667.  
  1668.        _______________________________________________________
  1669.  
  1670.         {rng=3}          Maximum number of alarm rings (1-999)
  1671.        _______________________________________________________
  1672.  
  1673.           Sets the number of times the alarm will ring.  You may press a
  1674.           key at any time to stop the alarm.
  1675.  
  1676.        ____________________________________________________________
  1677.  
  1678.         {sbs=10}         Scrollback buffer size in kilobytes (0-64)
  1679.        ____________________________________________________________
  1680.  
  1681.           The actual minimum size of the buffer (which {COMMO} will
  1682.           compute) depends on the number of screen lines and columns.  For
  1683.           a 25x80 screen it will be about 4k bytes -- it will be larger for
  1684.           screens with more lines and/or columns.  This includes room to
  1685.           save the current screen.
  1686.  
  1687.           Setting the size to 0 disables the Scrollback feature.  See also
  1688.           "Scrollback."
  1689.  
  1690.        _________________________________________________________________
  1691.  
  1692.         {adn=no}         Auto-detect number of rows and columns (yes/no)
  1693.        _________________________________________________________________
  1694.  
  1695.           {COMMO} will support 25 to 127 rows and 80 to 255 columns on the
  1696.           display, but you MUST set the display into the proper mode before
  1697.           starting the program (EGA/VGA adapters usually come with
  1698.           utilities to set modes such as 50x80, 44x132, etc.).
  1699.  
  1700.           Set this item to "yes" if you want {COMMO} to automatically
  1701.           obtain the current number of rows and columns from the system. 
  1702.           Most systems provide this information.  If the display is
  1703.           unsatisfactory, you may have to set it to "no."
  1704.  
  1705.  
  1706.  
  1707.                    {COMMO} (tm)  User Guide and Reference           page 27
  1708.  
  1709.  
  1710.           NOTE:  The cursor may not display properly in 43 line mode.  This
  1711.           is a problem with some EGA adapters.
  1712.  
  1713.        ___________________________________________________________
  1714.  
  1715.         {ucw=18}         Number of lines in upper Chat Mode window
  1716.        ___________________________________________________________
  1717.  
  1718.           This allows you to adjust the line "split" in Chat Mode.  The
  1719.           minimum number of lines in the upper or lower window is three.
  1720.  
  1721.        __________________________________________________________________
  1722.  
  1723.         {swe=no}         Send when Enter is pressed in Chat Mode (yes/no)
  1724.        __________________________________________________________________
  1725.  
  1726.           If "no" {COMMO} will send each character as you type it.  If
  1727.           "yes" {COMMO} will wait until you press Enter, then send all that
  1728.           you have typed.
  1729.  
  1730.        ____________________________________________________
  1731.  
  1732.         {sfi=no}         Speech Friendly Interface (yes/no) 
  1733.        ____________________________________________________
  1734.  
  1735.           If this is "yes" {COMMO} will be much friendlier to users with
  1736.           speech synthesizer boards (these enable blind users to read the
  1737.           computer display).  Terminal Screen data and many error and
  1738.           information messages will be displayed using the BIOS.  Also, the
  1739.           up and down arrow keys move the cursor instead of scrolling the
  1740.           screen in windows such as Online Help, Scrollback and View String
  1741.           Variable Space.
  1742.  
  1743.        _________________________________________________________________
  1744.  
  1745.         {bsc=no}         Use BIOS for Terminal Screen scrolling (yes/no)
  1746.         {sno=no}         Snow checking on CGA adapter (yes/no)
  1747.        _________________________________________________________________
  1748.  
  1749.           Change these video parameters only if necessary.
  1750.  
  1751.           o    BIOS scrolling enables external scrollback programs to work,
  1752.                but is slower and may cause "flicker" in certain displays.
  1753.  
  1754.           o    Snow checking will also slow the display, but will help to
  1755.                eliminate the "snow" effect on CGA monitors.
  1756.  
  1757.  
  1758.  
  1759.                    {COMMO} (tm)  User Guide and Reference           page 28
  1760.  
  1761.  
  1762.        _________________________________________________
  1763.  
  1764.         {ema=no}         Enable mono attributes (yes/no)
  1765.        _________________________________________________
  1766.  
  1767.           If this is "no" the default mono attributes will be used, no
  1768.           matter what colors are set in the following items.  Set it to
  1769.           "yes" if you want to set your own monochrome attributes (high
  1770.           intensity, reverse video, underline, etc.).  This has no effect
  1771.           on color displays.
  1772.  
  1773.        ____________________________________________
  1774.  
  1775.         {tsc=07}         Terminal Screen colors
  1776.         {slc=17}         Status Line colors
  1777.         {fwt=17}         File window text colors
  1778.         {fwb=70}         File window border colors
  1779.         {fws=3f}         File window cursor colors
  1780.         {swt=70}         Small window text colors
  1781.         {swb=17}         Small window border colors
  1782.        ____________________________________________
  1783.  
  1784.           Press F7 while editing the Setup File to pop up the color chart. 
  1785.           You may use it with color or monochrome displays.
  1786.  
  1787.           NOTE:  For the most accurate ANSI-BBS or VT102 terminal
  1788.           emulation, the Terminal Screen colors should be set to {07}.  In
  1789.           many cases, {COMMO} uses this color when clearing portions of the
  1790.           screen or when a "reset attributes" sequence is received from the
  1791.           host.
  1792.  
  1793.           "File windows" are full-screen windows such as the Dialing
  1794.           Directory, Macro File, Scrollback Buffer, etc.  "Small windows"
  1795.           are the pop up windows such as Capture File Options or ASCII
  1796.           Upload.
  1797.  
  1798.           Colors should be set so that the different parts of the screen
  1799.           contrast with each other.  For example the Status Line should be
  1800.           easily discernable from the rest of the Terminal Screen.  And the
  1801.           borders and Selector Bar should stand out against the text
  1802.           portion of the file windows.
  1803.  
  1804.  
  1805.        (End of Setup File items)
  1806.  
  1807.  
  1808.  
  1809.                    {COMMO} (tm)  User Guide and Reference           page 29
  1810.  
  1811.  
  1812.        =================
  1813.        [Alt-H]   Hang Up
  1814.        =================
  1815.  
  1816.        Disconnects the call by dropping DTR.  This will put the modem "on-
  1817.        hook" if response to DTR is enabled (see Appendix A).  If your modem
  1818.        does not respond properly, you may define a macro to send a "hang-
  1819.        up" command.  For modems using the "AT" command set the macro would
  1820.        look like this:
  1821.  
  1822.           {alh} {send ~~~+++~~~ATH|} {}    Press Alt-H to hangup
  1823.           
  1824.        Of course, you may assign this macro to any key you like.
  1825.  
  1826.  
  1827.        ===========================
  1828.        [Alt-I]   Screen Image Save
  1829.        ===========================
  1830.  
  1831.        The Screen Image Save is used to append all of the text currently on
  1832.        the screen to a disk file.  This is sometimes handier than
  1833.        repeatedly opening and closing the Capture File.
  1834.  
  1835.        TIPS on using Screen Image Save:
  1836.  
  1837.        >  The pathname may not be the same as the pathname of an open
  1838.           Capture File.
  1839.  
  1840.        >  If the file cannot be opened, the old pathname is retained.
  1841.  
  1842.        NOTE:  The current Screen Image Save file is also used to save
  1843.        blocks of text in the Scrollback feature.
  1844.  
  1845.        See also "Capture File Options" and "Scrollback."
  1846.  
  1847.  
  1848.        ====================
  1849.        [Alt-K]   Scrollback
  1850.        ====================
  1851.  
  1852.        Scrollback allows you to see what was previously on your screen. 
  1853.        Screen data is saved to a memory buffer (the size is defined in the
  1854.        Setup File).  Set the size to 0 to disable the feature entirely.
  1855.  
  1856.        A number of commands are available in Scrollback:
  1857.  
  1858.        1) You may navigate as in the Online Help file -- scroll up/down,
  1859.           page up/down, beginning/end of buffer, etc.
  1860.  
  1861.        2) Use the String Search feature available in all {COMMO} file
  1862.           windows.
  1863.  
  1864.  
  1865.  
  1866.                    {COMMO} (tm)  User Guide and Reference           page 30
  1867.  
  1868.  
  1869.        3) Change the Screen Image Save pathname.
  1870.  
  1871.        4) Write any part of the Scrollback buffer to the current Screen
  1872.           Image Save file.
  1873.  
  1874.        5) Exit and return to the same place the next time you call
  1875.           Scrollback.
  1876.  
  1877.        6) Jump directly to the Dialing Directory or Macro Processor
  1878.           windows.
  1879.  
  1880.  
  1881.        =========================
  1882.        [Alt-M]   Macro Processor
  1883.        =========================
  1884.  
  1885.        The Macro Processor executes and maintains {COMMO} macros.  See the
  1886.        Macro Programming Guide, MACRO.DOC, which shows you how easily you
  1887.        can automate program operations, link to external protocols (used
  1888.        for Uploading/Downloading), assign keys and perform a myriad of
  1889.        other functions.  The Macro File is maintained with the Internal
  1890.        Editor.
  1891.  
  1892.        See Online Help for details on operations within the Macro Processor
  1893.        window.
  1894.  
  1895.  
  1896.        ==============================
  1897.        [Alt-N]   Multi Number Dialing
  1898.        ==============================
  1899.  
  1900.        Any number of entries may be "marked" in the Dialing Directory, then
  1901.        automatically dialed in sequence until a connection is established. 
  1902.        Multi Number Dialing may be initiated in one of four ways:
  1903.  
  1904.        1) Bring up the Dialing Directory window with Alt-D, then move the
  1905.           Selector Bar to each desired entry and press [Space] (repeat the
  1906.           procedure to unmark an entry).  Press Alt-N to begin dialing at
  1907.           the location of the Selector Bar.
  1908.  
  1909.        2) Specify entries with Dialing Strings on the command line used to
  1910.           run {COMMO} (see "Command Line Options").  Specified entries will
  1911.           be marked and dialed in sequence when {COMMO} is started.
  1912.  
  1913.        3) Specify entries with Dialing Strings in a macro, using the MARK
  1914.           function (see MACRO.DOC).
  1915.  
  1916.        4) Press Alt-N from the Terminal Screen.  Dialing of marked entries
  1917.           will resume with the next system in the sequence.
  1918.  
  1919.        See also "[Alt-D]  Dialing Directory" and the DIAL function in
  1920.        MACRO.DOC. 
  1921.  
  1922.  
  1923.  
  1924.                    {COMMO} (tm)  User Guide and Reference           page 31
  1925.  
  1926.  
  1927.  
  1928.  
  1929.        ==========================================
  1930.        [Alt-O]   Send Modem Initialization String
  1931.        ==========================================
  1932.  
  1933.        Pressing Alt-O at any time from the Terminal Screen will cause the
  1934.        Modem Initialization String to be sent to the modem (if one is
  1935.        defined).  This is useful if your modem was powered off or if the
  1936.        modem setup was changed.
  1937.  
  1938.  
  1939.        =================================
  1940.        [Alt-P]   Set Terminal Parameters
  1941.        =================================
  1942.  
  1943.        The Terminal Parameters affect the transmission of data to and from
  1944.        your computer.  They are usually displayed or defined with a string. 
  1945.        For example:
  1946.  
  1947.                {2400,8n1,1,A,0}    Speed,format,port,terminal,delay.
  1948.  
  1949.        {COMMO} keeps two complete sets of Terminal Parameters:
  1950.  
  1951.           1)   The Current Parameters as shown on the left side of the
  1952.                Status Line.
  1953.  
  1954.           2)   The Default Dialing Parameters.  These will be set each time
  1955.                a number is dialed unless overridden by parameters in the
  1956.                Dialing Directory.
  1957.  
  1958.  
  1959.        Parameter Descriptions
  1960.        ======================
  1961.  
  1962.           _____
  1963.  
  1964.           Speed
  1965.           _____
  1966.  
  1967.        The rate at which data travels between your computer and your modem
  1968.        (or remote system if no modem is used).  It is specified as "bits
  1969.        per second" or "bps."  Allowable values are 300, 600, 1200, 2400,
  1970.        4800, 9600, 19200, 38400, 57600, 115200.  These may be abbreviated
  1971.        to the first two characters in Serial Port Parameter strings.
  1972.  
  1973.        See "AutoBaud Detect" for more information on setting the Speed.
  1974.  
  1975.  
  1976.  
  1977.                    {COMMO} (tm)  User Guide and Reference           page 32
  1978.  
  1979.  
  1980.           ___________
  1981.  
  1982.           Data Format
  1983.           ___________
  1984.  
  1985.        This consists of three parts.  Allowable values are:
  1986.  
  1987.           character length:   7, 8
  1988.           parity:             [n]one, [e]ven, [o]dd, [m]ark, [s]pace
  1989.           stop-bits:          1, 2
  1990.  
  1991.        Examples:
  1992.  
  1993.           7o2       7 bit characters, odd parity, 2 stop bits
  1994.           8m1       8 bit characters, mark parity, 1 stop bit
  1995.  
  1996.        The most common formats, "8n1" and "7e1", may be abbreviated to "8"
  1997.        and "7" in parameter strings, such as:
  1998.  
  1999.           {2400,8,1,A,0}
  2000.  
  2001.           ___________
  2002.  
  2003.           Serial Port
  2004.           ___________
  2005.  
  2006.        The channel your computer uses to talk to the outside world.  May be
  2007.        1, 2, 3 or 4 (for Com1, Com2, Com3 or Com4).
  2008.  
  2009.        NOTE:  PCjr users without the internal modem should specify Com2.
  2010.  
  2011.           _______________________
  2012.  
  2013.           Terminal Emulation Type
  2014.           _______________________
  2015.  
  2016.        {COMMO} supports the following terminal types:
  2017.  
  2018.           ANSI-BBS (A)   for calling most bulletin board systems
  2019.           VT102    (V)   for calling certain mainframes and online services
  2020.           TTY      (T)   for turning off almost all control functions (lets
  2021.                          you see ANSI control sequences).
  2022.  
  2023.           _____________________
  2024.  
  2025.           Inter-Character Delay
  2026.           _____________________
  2027.  
  2028.        This factor defines the amount of delay to insert between characters
  2029.        transmitted by the SEND macro function and by ASCII Upload.  Use
  2030.        only when the remote is too slow to process the data (drops
  2031.        characters).
  2032.  
  2033.  
  2034.  
  2035.                    {COMMO} (tm)  User Guide and Reference           page 33
  2036.  
  2037.  
  2038.  
  2039.        Each unit is about 5 thousandths of a second (5 ms) on a 4.77 MHz XT
  2040.        class machine.  Faster machines require higher values -- on a 12 MHz
  2041.        AT each unit will only be about 1 ms.
  2042.  
  2043.        For example, to delay 20 ms between characters (50 cps) use a factor
  2044.        of:
  2045.  
  2046.                 4 on 4.77 MHz XT
  2047.                16 on 12 MHz AT
  2048.                27 on 20 MHz 386
  2049.  
  2050.        The factor will also vary when you use multi-tasking software, so
  2051.        adjust as necessary.  The maximum delay allowed is one second.
  2052.  
  2053.  
  2054.        Setting Terminal Parameters
  2055.        ===========================
  2056.  
  2057.           __________________________
  2058.  
  2059.           With the Alt-P Key Command
  2060.           __________________________
  2061.  
  2062.        Alt-P may be used at any time to change the Current Parameters or
  2063.        the Default Dialing Parameters.  Remember that Current Parameters
  2064.        will be reset to the Default Dialing Parameters whenever dialing
  2065.        begins.
  2066.  
  2067.           ________________________
  2068.  
  2069.           In the Dialing Directory
  2070.           ________________________
  2071.  
  2072.        Serial Port Parameters may be specified in a Dialing Directory entry
  2073.        to override the Default Dialing Parameters.  Specify only values
  2074.        that are different.  For example:
  2075.  
  2076.           {,,3,V}   A different serial port and terminal emulation is
  2077.                     required for this call.
  2078.  
  2079.           {,8o2}    Unusual format required.
  2080.  
  2081.           __________________________________________
  2082.  
  2083.           Using the Macro functions PARMs and DPARms
  2084.           __________________________________________
  2085.  
  2086.        Use these to set parameters during macro execution.  See MACRO.DOC.
  2087.  
  2088.  
  2089.  
  2090.                    {COMMO} (tm)  User Guide and Reference           page 34
  2091.  
  2092.  
  2093.        ======================
  2094.        [Alt-S]   Shell to DOS
  2095.        ======================
  2096.  
  2097.        When you Shell to DOS {COMMO} remains resident in memory and you may
  2098.        perform any DOS functions as you normally do.  Since {COMMO} is
  2099.        small in size, most of your memory is available when you use this
  2100.        key command.
  2101.  
  2102.  
  2103.        =====================
  2104.        [Alt-T]   Set Toggles
  2105.        =====================
  2106.  
  2107.        This key command is used to set a number of miscellaneous toggle
  2108.        (yes/no) parameters.  Some take effect while you are still in the
  2109.        Set Toggles window -- others when you exit the window.
  2110.  
  2111.        Some of the toggles will be described here.  The others are detailed
  2112.        in their respective sections of this document.
  2113.  
  2114.  
  2115.        Sound Control Toggle
  2116.        ====================
  2117.  
  2118.        This is the Master Sound Control toggle.  When sound is OFF all
  2119.        alarms, sounds and beeps will be silenced.  Alarms are individually
  2120.        controlled with items in the Setup File and with the "A" switch in
  2121.        EXECute macro functions.
  2122.  
  2123.  
  2124.        AutoBaud Toggle
  2125.        ===============
  2126.  
  2127.        AutoBaud Detect enables {COMMO} to automatically adjust to the line
  2128.        speed of the system you are calling.  You won't have to hang up and
  2129.        call back when you get the wrong speed.
  2130.  
  2131.        TIPS on using AutoBaud:
  2132.  
  2133.        >  Your modem must be set to return the connection speed responses
  2134.           such as "CONNECT 1200" (see Appendix A "Setting Up Your Modem").
  2135.  
  2136.        >  The Default Dialing Speed in the Setup File should be set to your
  2137.           modem's highest speed.
  2138.  
  2139.  
  2140.  
  2141.                    {COMMO} (tm)  User Guide and Reference           page 35
  2142.  
  2143.  
  2144.           ____________________
  2145.  
  2146.           Most 2400 bps modems
  2147.           ____________________
  2148.  
  2149.        Toggle AutoBaud Detect to the ON state.  Set the Default Dialing
  2150.        Speed in the Setup File to 2400.  The following result-codes will
  2151.        cause the indicated actions:
  2152.  
  2153.           CONNECT 2400  -->  serial port remains at 2400 bps
  2154.           CONNECT 1200  -->  serial port adjusted to 1200 bps
  2155.           CONNECT       -->  serial port adjusted to 300 bps
  2156.  
  2157.           _________________
  2158.  
  2159.           High-speed modems
  2160.           _________________
  2161.  
  2162.  
  2163.        Most high-speed modems require that the serial port be "locked" at
  2164.        19200 bps or 38400 bps.  The modem will then automatically adjust to
  2165.        the line (modem-to-modem) speed.  In this case AutoBaud must be
  2166.        turned OFF to prevent {COMMO} from changing the serial port speed.
  2167.  
  2168.        IMPORTANT!  Check your modem manual for details.
  2169.  
  2170.  
  2171.        Local Echo Toggle
  2172.        =================
  2173.  
  2174.        Local Echo (sometimes called half-duplex) is normally used when you
  2175.        connect to a host that does not echo what you type.  {COMMO} will
  2176.        assume that the host is sending a linefeed with each carriage
  2177.        return.
  2178.  
  2179.        Typed characters will be displayed directly to the screen.
  2180.  
  2181.  
  2182.        Signal Lights Toggle
  2183.        ====================
  2184.  
  2185.        Turns ON/OFF the "modem lights" display on the status line.  Shows
  2186.        the state of the RS-232C signals, including send and receive.
  2187.  
  2188.        This toggles the right half of the Status Line from the System Name
  2189.        to the Signal Lights Display.  See "What is on the Status Line" in
  2190.        Online Help for a complete description of the Status Line
  2191.        indicators.
  2192.  
  2193.  
  2194.  
  2195.                    {COMMO} (tm)  User Guide and Reference           page 36
  2196.  
  2197.  
  2198.        ======================
  2199.        [Alt-U]   Utility Menu
  2200.        ======================
  2201.  
  2202.        The Utility Menu is supported by a macro in COMMO.MAC.  It contains
  2203.        a selection of features created by {COMMO} macros.
  2204.  
  2205.        Example features include:
  2206.  
  2207.           Edit any external text file less than 64k in size.
  2208.           Run any macro by name.
  2209.           Run the host mode macro, MOSTHOST.MAC.
  2210.           Edit the host mode macro.
  2211.  
  2212.        NOTE:  The Utility Menu will not be available when another Macro
  2213.        File has been loaded by the MACLoad macro function.
  2214.  
  2215.  
  2216.        ===============================
  2217.        [Alt-W]   Send Current Password
  2218.        ===============================
  2219.  
  2220.        Each entry in the Dialing Directory can have its own Password
  2221.        String.  After dialing a number, the Alt-W key command will send the
  2222.        current Password String to the remote system.
  2223.  
  2224.        For additional details on Passwords see "[Alt-D]  Dialing
  2225.        Directory."
  2226.  
  2227.  
  2228.        ===========================
  2229.        [Alt-X]   Exit from {COMMO}
  2230.        ===========================
  2231.  
  2232.        This key command will cause {COMMO} to terminate, saving all support
  2233.        files with outstanding changes.
  2234.  
  2235.        You may configure {COMMO} to leave DTR high when exiting so that you
  2236.        may exit and remain connected to a system (this is the default, see
  2237.        "[Alt-G]  Edit Setup File").
  2238.  
  2239.        If you re-enter {COMMO} while still online you should use the "/in"
  2240.        command line switch to prevent the Modem Initialization String from
  2241.        being sent.
  2242.  
  2243.        Alt-X may also be pressed from the Dialing Directory or Macro File
  2244.        windows for a quick exit.
  2245.  
  2246.  
  2247.  
  2248.                    {COMMO} (tm)  User Guide and Reference           page 37
  2249.  
  2250.  
  2251.        ==============================
  2252.        [Alt-1]   Capture File Options
  2253.        ==============================
  2254.  
  2255.        When Capture is OPEN all information written to your screen will be
  2256.        saved to the designated disk file.  This command allows you to:
  2257.  
  2258.           1)   OPEN/CLOSE the Capture File.
  2259.           2)   Change to a different file.
  2260.           3)   Change the Capture Mode.
  2261.  
  2262.        Data may be captured in one of three modes.  The startup Capture
  2263.        Mode is selected in the Setup File.
  2264.  
  2265.           If the mode is set to SCREEN, data will be captured exactly as it
  2266.           appears on the Terminal Screen.  This mode greatly improves the
  2267.           appearance of data captured from screens drawn with ANSI
  2268.           positioning sequences (animation).
  2269.  
  2270.           FILTER mode is used primarily when you need to capture lines
  2271.           longer than the width of the screen (e.g., to be printed on a
  2272.           wide carriage printer).  ANSI controls will still be stripped out
  2273.           if ANSI-BBS or VT102 emulation is on.
  2274.  
  2275.           Use RAW mode when you want all data captured exactly as it comes
  2276.           from the serial port.  ANSI control sequences will not be
  2277.           stripped and length of lines will be preserved.  This mode can be
  2278.           used to capture ANSI animation and color to be "played back"
  2279.           later.
  2280.  
  2281.        TIPS on using the Capture File:
  2282.  
  2283.        >  IMPORTANT!  When capturing to a floppy drive, the diskette should
  2284.           not be removed until the Capture File is closed (this also
  2285.           applies if the "disk full" message appears).  DOS is unaware of a
  2286.           disk change and may overwrite the replacement disk.
  2287.  
  2288.        >  The old file will be closed if a new file is opened.
  2289.  
  2290.        >  If Capture Mode is set to SCREEN, text will be saved as it
  2291.           scrolls OFF the screen.  To prevent loss of data, the entire
  2292.           screen will be saved in the following situations:
  2293.  
  2294.                (1) whenever the screen is cleared
  2295.                (2) Capture is closed with Alt-1
  2296.                (3) {COMMO} is terminated
  2297.                (4) the mode is changed from SCREEN to FILTER or RAW
  2298.  
  2299.        >  If Capture Mode is set to FILTER or RAW, text will be saved as it
  2300.           arrives from the serial port.
  2301.  
  2302.        See also "Screen Image Save."
  2303.  
  2304.  
  2305.  
  2306.                    {COMMO} (tm)  User Guide and Reference           page 38
  2307.  
  2308.  
  2309.  
  2310.  
  2311.        ==========================
  2312.        [Alt-2]   Print Log Toggle
  2313.        ==========================
  2314.  
  2315.        Turns the Print Log ON/OFF.  When ON all information written to your
  2316.        screen will be printed to LPT1.  Handy for getting hard-copy of file
  2317.        lists, messages, etc.
  2318.  
  2319.        TIPS on using the Print Log:
  2320.  
  2321.        >  Text is printed as it scrolls OFF the screen.
  2322.  
  2323.        >  To prevent loss of data, the entire screen will be printed in the
  2324.           following situations:
  2325.  
  2326.                (1) whenever the screen is cleared
  2327.                (2) Print Log is turned off with Alt-2
  2328.                (3) {COMMO} is terminated
  2329.  
  2330.        >  Flow Control should be used if your printer cannot keep up with
  2331.           the incoming data (see Appendix C).
  2332.  
  2333.  
  2334.        ==========================
  2335.        [Alt--]   Chat Mode Toggle  (Alt minus)
  2336.        ==========================
  2337.  
  2338.        Chat Mode is normally used when you wish to converse via keyboard.
  2339.        The screen will be split with the upper portion showing what the
  2340.        remote is sending, while the lower portion shows what you type.
  2341.  
  2342.        The method used to send typed characters is selected in the Setup
  2343.        File under the section "Video and Chat Mode."  The two possible
  2344.        methods are:
  2345.  
  2346.           1)   Each character is sent as you type it.  This method is
  2347.                normally used when you are chatting with another person who
  2348.                is also in Chat Mode.
  2349.  
  2350.           2)   All characters are sent at once when you press Enter (up to
  2351.                240 characters will be buffered).  Use this method when you
  2352.                are using a teleconferencing system or "CB Simulator."
  2353.  
  2354.        The number of lines in the upper and lower portions of the screen
  2355.        (the "line split") may also be set in the "Video and Chat Mode"
  2356.        section.
  2357.  
  2358.        TIPS on using Chat Mode:
  2359.  
  2360.        >  Alt-- (Alt minus) is used to enter AND exit Chat Mode.
  2361.  
  2362.  
  2363.  
  2364.                    {COMMO} (tm)  User Guide and Reference           page 39
  2365.  
  2366.  
  2367.  
  2368.        >  All {COMMO} functions are available in Chat Mode except Doorway
  2369.           Mode.
  2370.  
  2371.  
  2372.        =============================
  2373.        [Alt-=]   Doorway Mode Toggle
  2374.        =============================
  2375.  
  2376.        Definition: "Extended keys" are function keys, Alt keys, cursor
  2377.        keys, etc.  In other words, keys that do not generate ASCII
  2378.        characters.
  2379.  
  2380.        In Doorway Mode all extended keys will send their key codes to the
  2381.        remote (instead of activating {COMMO} functions).  Thus Doorway Mode
  2382.        can be used to operate most application software on the remote
  2383.        system when used with a host program such as Marshall Dudley's
  2384.        Doorway.  In addition some BBS full-screen editors use Doorway Mode.
  2385.  
  2386.        TIPS on using Doorway Mode:
  2387.  
  2388.        >  The Alt-= key is necessarily reserved for exiting Doorway Mode
  2389.           and thus cannot be sent to the remote.  Be sure to configure
  2390.           remote applications accordingly.
  2391.  
  2392.        >  The display should be set to the number of lines expected by the
  2393.           host program.  Usually this is 25 lines of text.  If your display
  2394.           is not in the proper mode, the results will be unpredictable.
  2395.  
  2396.        >  The Status Line is normally suppressed in Doorway Mode, but may
  2397.           be turned on by using the "S" switch in a macro:
  2398.  
  2399.                {:al=} {doorway-s} {}
  2400.  
  2401.           The "s" switch is ignored when exiting Doorway Mode and the
  2402.           Status Line will be restored to its previous state.  Remember
  2403.           that when the Status Line is on, there is one less usable line on
  2404.           the Terminal Screen.
  2405.  
  2406.        >  If it is necessary to clear the screen or to reset the terminal
  2407.           emulation mode parameters when starting Doorway Mode, use a
  2408.           macro.  For example:
  2409.  
  2410.                {:al=} {clear} {parms ,,,a} {doorway} {}
  2411.  
  2412.           This macro will execute when entering or exiting Doorway Mode
  2413.           (Alt-= must be used to exit, but any key may be assigned to enter
  2414.           Doorway Mode).
  2415.  
  2416.        >  For most applications you will want Terminal-Type set to
  2417.           ANSI-BBS.  It's a good idea to enter Doorway Mode before starting
  2418.  
  2419.  
  2420.  
  2421.                    {COMMO} (tm)  User Guide and Reference           page 40
  2422.  
  2423.  
  2424.           the host program.  The host may send commands to initialize the
  2425.           terminal.
  2426.  
  2427.        >  If Software Flow Control is enabled, the ASCII character values
  2428.           17 and 19 (XON and XOFF) will not display.  If these characters
  2429.           are needed, Software Flow Control must be turned off.
  2430.  
  2431.  
  2432.        =============================
  2433.        [F1]   How to Use Online Help
  2434.        =============================
  2435.  
  2436.        A summary of {COMMO}'s operations is available by pressing F1.  The
  2437.        Online Help support file, COMMO.HLP, must be in the {COMMO} home
  2438.        directory or you will get an error message.
  2439.  
  2440.        This message will also be issued if there is not enough memory to
  2441.        load the Online Help file.  Note that the file is retained in memory
  2442.        until {COMMO} requires memory for some other program function.  It
  2443.        will automatically be re-read when necessary. 
  2444.  
  2445.        Once the Help window is entered you will see the Help control keys
  2446.        listed at the bottom of the screen.  At this point you may obtain
  2447.        more detailed information about using Online Help by typing "H".
  2448.  
  2449.  
  2450.        Modifying the Help File
  2451.        =======================
  2452.  
  2453.        When you are familiar with {COMMO} you may wish to reduce the size
  2454.        of the Help File.  Feel free to edit this file -- you can even set
  2455.        up your own menu.
  2456.  
  2457.        The search keys are in the bars separating the topics.  The
  2458.        character following the "T" in the middle of the bar may be changed
  2459.        to create your own key.  Keep in mind that the context-related Help
  2460.        uses topic characters that cannot be changed.
  2461.  
  2462.        The HELP macro function enables you to assign a key to go directly
  2463.        to any topic in Online Help.  For example:
  2464.  
  2465.                {:cf6} {help J} {}
  2466.  
  2467.        will go to topic "TJ" when Ctrl-F6 is pressed.  Use any single
  2468.        character as the key (do not include the "T").
  2469.  
  2470.        If you change the Help File, remember to keep a backup copy of the
  2471.        original.
  2472.  
  2473.  
  2474.  
  2475.                    {COMMO} (tm)  User Guide and Reference           page 41
  2476.  
  2477.  
  2478.        ====================================
  2479.        [PgUp]/[PgDn]  Uploading/Downloading
  2480.        ====================================
  2481.  
  2482.        When you press PgUp or PgDn you will be presented with a menu from
  2483.        which you may select a file transfer protocol.  Protocols provide
  2484.        the ability to transfer any kind of data using error correction
  2485.        methods.
  2486.  
  2487.        {COMMO} has the Xmodem and Xmodem-1k (old Ymodem) protocols built in
  2488.        and provides you with macros to send and receive.  In addition the
  2489.        Macro File is pre-configured with macros that execute various
  2490.        popular protocol drivers, including DSZ which performs Zmodem,
  2491.        Ymodem Batch and Ymodem-G uploads and downloads.
  2492.  
  2493.        The PgUp and PgDn menus are implemented using {COMMO}'s powerful
  2494.        Macro Processor which enables you to execute internal and external
  2495.        protocols easily and seamlessly (see below for details on obtaining
  2496.        and installing several of these drivers).
  2497.  
  2498.        You may add macros for any other protocol drivers that you need. 
  2499.        See the Macro Programming Guide, MACRO.DOC, for details on writing
  2500.        macros.
  2501.  
  2502.  
  2503.        How to Install External Protocol Drivers
  2504.        ========================================
  2505.  
  2506.        Protocols such as Zmodem, HS/Link and MPt offer greater convenience,
  2507.        speed and reliability.  They include features such as:
  2508.  
  2509.           1) Automatic startup.
  2510.           2) Transmission of file names, sizes and dates.
  2511.           3) Batch (multiple file) transfers.
  2512.           4) Resuming partial (failed) transfers.
  2513.           5) Bi-directional transfers (HS/Link only)
  2514.  
  2515.        External protocol "drivers" can be obtained from BBS's and other
  2516.        sources.  You can download them using {COMMO}'s internal protocols.
  2517.  
  2518.        To install DSZ, HS/Link, MPt or OZBEXT, just place the executable
  2519.        file (e.g., DSZ.COM, HSLINK.EXE, MPT.EXE, OZBEXT.EXE) in a directory
  2520.        which is specified in your DOS path statement.  If you don't have a
  2521.        path statement in your AUTOEXEC.BAT file, place the executable in
  2522.        your C:\COMMO directory.  In the latter case, change to this
  2523.        directory before you start {COMMO}.
  2524.  
  2525.        Each of the protocol driver programs has additional features that
  2526.        may be useful to you.  Refer to the program's documentation for more
  2527.        information.
  2528.  
  2529.  
  2530.  
  2531.                    {COMMO} (tm)  User Guide and Reference           page 42
  2532.  
  2533.  
  2534.        Using DSZ or GSZ
  2535.        ================
  2536.  
  2537.        NOTE:  These are Shareware programs from Omen Technology.  Like
  2538.        {COMMO}, they must be registered for continued use (some features
  2539.        are not enabled in the unregistered versions).  DSZ may almost
  2540.        always be found where you obtained {COMMO} and is usually archived
  2541.        as DSZmmdd.ZIP (mmdd is a release date).
  2542.  
  2543.        DSZ will transfer files using Zmodem, Ymodem Batch and Ymodem-G.
  2544.  
  2545.        The executable file to install is DSZ.COM.
  2546.  
  2547.        GSZ is functionally equivalent to DSZ.  In addition GSZ provides an
  2548.        attractive graphic display of the file transfer in progress.  To use
  2549.        GSZ you need only change one item in the Setup file:
  2550.  
  2551.           {set dszprog,GSZ.EXE}
  2552.  
  2553.        The executable file to install is GSZ.EXE.
  2554.  
  2555.  
  2556.        Using HS/Link
  2557.        =============
  2558.  
  2559.        HS/Link is a Shareware program that offers very fast file transfers. 
  2560.        It also has bi-directional capability for uploading and downloading
  2561.        simultaneously (make sure the remote system allows this feature
  2562.        before attempting it).
  2563.  
  2564.        When you select a download with HS/Link (or if it is started
  2565.        automatically, see "Auto Receive"), you will be asked to enter a
  2566.        "Filename to Upload" as well.  Just press Enter for download only.
  2567.  
  2568.        Note that your download directory must be specified in HSLINK.CFG or
  2569.        received files will be placed in the current directory.  For
  2570.        example, if your download directory is "c:\dlfiles", put the line
  2571.        "-uc:\dlfiles" in your HSLINK.CFG.
  2572.  
  2573.        The executable file to install is HSLINK.EXE.
  2574.  
  2575.  
  2576.        Using MPt
  2577.        =========
  2578.  
  2579.        MPt is a Shareware program that transfers files using the MPt
  2580.        protocol (similar to Zmodem, but not compatible).  It offers an
  2581.        excellent graphic display during file transfers.
  2582.  
  2583.        The executable file to install is MPT.EXE.
  2584.  
  2585.  
  2586.  
  2587.                    {COMMO} (tm)  User Guide and Reference           page 43
  2588.  
  2589.  
  2590.        Using OZBEXT
  2591.        ============
  2592.  
  2593.        OZBEXT is a file transfer program for CompuServe users (it is
  2594.        available without charge from CIS).  This protocol offers much
  2595.        better network throughput than Xmodem.
  2596.  
  2597.        OZBEXT will transfer files using the "B" and "B+" protocols.
  2598.  
  2599.        The executable file to install is OZBEXT.EXE.
  2600.  
  2601.  
  2602.        {COMMO} Auto Receive
  2603.        ====================
  2604.  
  2605.        This feature will automatically start a macro when a specified
  2606.        string is received from the serial port and is normally used for
  2607.        starting downloads.
  2608.  
  2609.        Up to 8 strings and respective macro labels may be defined in the
  2610.        "Terminal and Modem" section of the Setup File.  These are
  2611.        preconfigured for the Zmodem, HS/Link and MPt protocol "signature"
  2612.        strings, but you may change them or add new ones as desired.
  2613.  
  2614.        As an example, suppose one of the Auto Receive strings in your Setup
  2615.        File is:
  2616.  
  2617.                {pzbr,^XB00}        Zmodem Auto Receive
  2618.  
  2619.        This means that when the string "^XB00" is received, the macro at
  2620.        label "pzbr" will be started.  This string is the Zmodem signature
  2621.        string.
  2622.  
  2623.        In your Macro File you would have the corresponding macro:
  2624.  
  2625.          Z BATCH  {:pzbr} {exec %dszprog port %_por rz -mr %dldir} {}
  2626.  
  2627.        {COMMO} will execute the macro as soon as the signature string is
  2628.        received (be patient, a BBS may take several seconds to load and
  2629.        execute its own protocol program).
  2630.  
  2631.        IMPORTANT!  If you have not properly installed the protocol program,
  2632.        the message "Bad command or file name" will be periodically
  2633.        displayed by DOS.  If this happens type Ctrl-X repeatedly until the
  2634.        sender cancels the transfer.
  2635.  
  2636.        TIPS on using Auto Receive:
  2637.  
  2638.        >  If the macro called by Auto Receive EXECutes a DOS command, you
  2639.           may want to use EXECute Preview Mode for preliminary testing. 
  2640.           This will allow you to view the command before execution and to
  2641.  
  2642.  
  2643.  
  2644.                    {COMMO} (tm)  User Guide and Reference           page 44
  2645.  
  2646.  
  2647.           see the results afterwards.  Preview Mode may be toggled on/off
  2648.           using the Alt-T key command.
  2649.  
  2650.        >  Auto Receive will not trigger on characters that are displayed to
  2651.           the screen while a macro is running.
  2652.  
  2653.        >  The serial port input buffer will be cleared following any
  2654.           EXECute function that is part of an Auto Receive macro.  This
  2655.           prevents repeated signature strings from triggering the macro
  2656.           more than once.
  2657.  
  2658.        >  If you need to download within a macro, you should do a LOOKfor
  2659.           to wait for the signature string, then CALL the download macro
  2660.           (make sure you have a RETUrn at the end).
  2661.  
  2662.        >  Using short strings, such as "^E" for CIS B protocol may result
  2663.           in unexpected triggering of the macro.  This is because other
  2664.           systems may send the same string for a different purpose (to
  2665.           display a "club" symbol, for example).  Thus it may be necessary
  2666.           to disable a string at times or to discontinue its use.
  2667.  
  2668.        >  A string may be disabled by removing the corresponding macro
  2669.           label in the Macro File, but this degrades performance since the
  2670.           Macro File must be scanned each time a "hit" occurs.  Instead,
  2671.           the Setup File item should be removed.
  2672.  
  2673.        >  Auto Receive can be set up for protocols that do not send
  2674.           signature strings, such as Xmodem, Ymodem, Ymodem-G, etc.  Use
  2675.           the prompt that the BBS sends just prior to the file transfer. 
  2676.           For example, "Start your Ymodem-G now."  Note that different
  2677.           systems may use different prompts.
  2678.  
  2679.        >  An Auto Receive string can be used to automatically continue
  2680.           Multi Number Dialing after you disconnect (in manual mode).  Set
  2681.           one of the strings to:
  2682.  
  2683.                     {aut=nocar,^jNO CARRIER^m}
  2684.  
  2685.           Then enter a macro in the Macro File:
  2686.  
  2687.                     {:nocar} {dial ,} {}
  2688.  
  2689.           When your modem sends "NO CARRIER" the macro will start.  Multi
  2690.           Number Dialing will resume if any more systems are marked in the
  2691.           Dialing Directory.
  2692.  
  2693.        See also "TIPS on creating LOOKfor strings" in the section
  2694.        describing the LOOKfor function.
  2695.  
  2696.  
  2697.  
  2698.                    {COMMO} (tm)  User Guide and Reference           page 45
  2699.  
  2700.  
  2701.        ==========   =====================
  2702.        Appendix A   Setting Up Your Modem
  2703.        ==========   =====================
  2704.  
  2705.        Please be aware that there are many different modems in use and that
  2706.        it is of the utmost importance that you configure your modem to work
  2707.        correctly with {COMMO}.  A few tips will be given here, but they are
  2708.        no substitute for the detailed installation instructions in your
  2709.        modem manual!
  2710.  
  2711.        When {COMMO} is started, a command string called the Modem
  2712.        Initialization String will be sent to the modem.  You must make
  2713.        certain that you have the correct string in your Setup File.  This
  2714.        string will perform part or all of the modem setup depending on the
  2715.        type of modem.  Examples will be given for the most common types.
  2716.  
  2717.        If your modem is external to your computer, be sure you have
  2718.        followed the installation instructions carefully and that the cable
  2719.        is connected to the computer's serial port.  It is wise to turn off
  2720.        power to the computer and the modem when connecting or disconnecting
  2721.        any cables.
  2722.  
  2723.        Also check the Default Dialing Parameters in the Setup File.  Make
  2724.        sure the serial port number is correct.
  2725.  
  2726.           _______________
  2727.  
  2728.           1200 bps Modems
  2729.           _______________
  2730.  
  2731.        Most 1200 bps modems have switches on them which must be set to
  2732.        provide the proper interaction with your computer and with {COMMO}. 
  2733.        Consult your modem manual concerning these switches and pay
  2734.        particular attention to the following:
  2735.  
  2736.           1)   Enable command recognition.  Allows the modem to recognize
  2737.                commands (dial, set registers, etc.).  Must be in the
  2738.                "enable" position or modem will be unusable.
  2739.  
  2740.           2)   Send result codes in English.  This switch should be set so
  2741.                that the modem will send verbal responses to commands
  2742.                instead of numbers.  This is usually controlled by a command
  2743.                also (such as ATV1).
  2744.  
  2745.           3)   Respond to DTR (data terminal ready).  This should NOT be in
  2746.                the "ignore" or "on all the time" position.  This switch
  2747.                allows the computer to signal the modem to hang up.
  2748.  
  2749.           4)   Respond to carrier detect or "allow true carrier."  This
  2750.                should NOT be set to the "on all the time" position.
  2751.  
  2752.  
  2753.  
  2754.                    {COMMO} (tm)  User Guide and Reference           page 46
  2755.  
  2756.  
  2757.        Here is an example Modem Initialization String which will set up a
  2758.        1200 bps modem and override the switch settings (if possible):
  2759.  
  2760.           {~AT S0=0 S7=60 E0 Q0 V1 X1 |}
  2761.  
  2762.        The most important command to check is the "X" command, since its
  2763.        function varies the most from modem to modem.  The "X" command
  2764.        determines which responses the modem will generate during dialing
  2765.        (e.g. CONNECT, BUSY, etc.).  It may also activate an additional
  2766.        modem feature such as automatic redialing which will interfere with
  2767.        {COMMO}'s own redialing procedure.
  2768.  
  2769.        Your modem manual gives a description for each level of the "X"
  2770.        command: X0, X1, X2, ... , etc.  Generally you want to use the
  2771.        highest level that does not activate undesirable features.  If you
  2772.        will be using {COMMO}'s AutoBaud feature you will need the extended
  2773.        connect responses such as CONNECT 1200.  Also the BUSY response
  2774.        should be provided if possible.  In any case you should modify the
  2775.        Modem Initialization String to work with your particular modem.
  2776.  
  2777.           ___________________
  2778.  
  2779.           2400 bps and higher
  2780.           ___________________
  2781.  
  2782.        Modems which operate at 2400 bps and higher generally have commands
  2783.        to replace the switches (see the section above if yours has
  2784.        switches).  These commands may be given every time you start {COMMO}
  2785.        or they may be permanently remembered by modems which have "non-
  2786.        volatile" memory.
  2787.  
  2788.        It will be assumed here that the commands are given every time you
  2789.        start {COMMO}.  If you wish to place the settings in non-volatile
  2790.        memory, consult your modem manual on how to do this.  Here is an
  2791.        example Modem Initialization String for most 2400 bps modems:
  2792.  
  2793.           {~AT S0=0 S7=180 E0 Q0 V1 X4 &C1 &D2 |}
  2794.  
  2795.        See the comments above concerning the "X" command since they apply
  2796.        to these modems as well.
  2797.  
  2798.        IMPORTANT!  Many modems that operate at 2400 bps and above require
  2799.        additional commands to control features such as data compression and
  2800.        error correction.  Consult the modem manual for details.
  2801.  
  2802.        If you need to change the Modem Initialization String, edit the
  2803.        Setup File with the Alt-G key command, then restart the program to
  2804.        send the string to the modem.
  2805.  
  2806.  
  2807.  
  2808.                    {COMMO} (tm)  User Guide and Reference           page 47
  2809.  
  2810.  
  2811.        Answering a call from another computer
  2812.        ======================================
  2813.  
  2814.        There are two easy ways to use {COMMO} to answer when a friend or
  2815.        associate calls you by computer.  For best results, make sure you
  2816.        are in Chat Mode.  Press Alt-- (Alt minus) to enter/exit Chat Mode.
  2817.  
  2818.        1) While in Chat Mode or in the Terminal Screen, wait for the phone
  2819.           to ring, then type "ATA<cr>" (upper case is not necessary with
  2820.           many modems).  Your modem should answer immediately (go off hook)
  2821.           and begin handshaking with the remote modem.
  2822.  
  2823.           When you see the CONNECT message you are ready to communicate. 
  2824.           At this point you can type, send data with macro keys, send a
  2825.           text file with ASCII Upload or send any file with an external
  2826.           protocol.
  2827.  
  2828.           You can use a macro key to send the answer command to the modem. 
  2829.           For example, to send it by pressing Alt-W, place the following
  2830.           macro in your Macro File.  When the phone rings, press F5:
  2831.  
  2832.                {nf5} {send ATA|} {}     Answer the phone!
  2833.  
  2834.        2) The other method involves setting your modem into Auto Answer
  2835.           Mode.  This method is useful in some situations, but will cause
  2836.           the modem to answer whenever the phone rings.  This can be
  2837.           undesirable if you get a voice call.
  2838.  
  2839.           To set Auto Answer just type "ATS0=1<cr>" (or make "S0=1" part of
  2840.           your Modem Initialization String).  This will tell the modem to
  2841.           answer on ring "1" (adjust to as many rings as desired).  To turn
  2842.           off Auto Answer type "ATS0=0<cr>".  These may also be sent with
  2843.           macro keys. 
  2844.  
  2845.  
  2846.        Connecting two computers (null modem cable)
  2847.        ===========================================
  2848.  
  2849.        {COMMO} may be used on a "direct connection" between two computers
  2850.        or between a computer and another serial device.  Connect the two
  2851.        serial ports with a "null modem" cable.  Then start the program on
  2852.        each computer, having selected the appropriate Default Dialing
  2853.        Parameters in the Setup File(s).
  2854.  
  2855.        The null modem cable should be designed so that the transmit line on
  2856.        each end connects to the receive line on the other end.  No other
  2857.        signals are needed, but none of the RS-232C signals should be left
  2858.        "floating."  They should be tied high or low (or at least grounded).
  2859.  
  2860.        You may have to disable the Usage Log in the Setup File by setting
  2861.        the path to null: {set _uselog}.  The log is triggered by changes in
  2862.        Carrier Detect and will slow things down if CD is unpredictable.
  2863.  
  2864.  
  2865.  
  2866.                    {COMMO} (tm)  User Guide and Reference           page 48
  2867.  
  2868.  
  2869.  
  2870.  
  2871.        ==========   =========================
  2872.        Appendix B   {COMMO} and Multi-Tasking
  2873.        ==========   =========================
  2874.  
  2875.           ________
  2876.  
  2877.           DESQview
  2878.           ________
  2879.  
  2880.        Special care has been taken to ensure that {COMMO} is compatible
  2881.        with Quarterdeck Office Systems' DESQview(tm), a multi-tasking
  2882.        supervisor.  DESQview allows more than one program to execute at the
  2883.        same time.
  2884.  
  2885.        A sample Program Information File (CO-PIF.DVP) has been included in
  2886.        the {COMMO} package for your convenience.  This file is installed as
  2887.        follows:
  2888.  
  2889.           1)   Copy the file to your DESQview directory (usually C:\DV).
  2890.           2)   Run "Add a Program" (AP) from the "Open Window" menu.
  2891.           3)   Select "Other."  Specify the DESQview directory as the
  2892.                "Path."
  2893.           4)   Mark the {COMMO} entry, press Enter.  "CO" should now appear
  2894.                on your "Open Window" menu.
  2895.  
  2896.        The CO-PIF.DVP file has been set up to define a 150k memory window. 
  2897.        The amount of memory actually required is affected by the size of
  2898.        your COMMO.FON file, your COMMO.MAC file and the size of your
  2899.        Scrollback buffer.
  2900.  
  2901.        Test the size of the window by running DSZ, LIST, etc., from the
  2902.        Macro Processor or Shell to DOS.  Be sure to test the execution of
  2903.        external programs with a "wait" at the end (or use EXECute Preview
  2904.        Mode) so that you can see any error messages (see EXEC function).
  2905.  
  2906.        CO-PIF.DVP can be changed with the "Change a Program" (CP) command
  2907.        on the "Open Window" menu.  You may also want to change the
  2908.        directory information or other parameters.
  2909.  
  2910.        TIPS on using {COMMO} with DESQview:
  2911.  
  2912.        >  For best performance the foreground and background "tick counts"
  2913.           should both be 10 or less.
  2914.  
  2915.        >  If you switch to another task, do not attempt to access any files
  2916.           which may be in use in the {COMMO} window.  Examples are the
  2917.           Capture File, the Screen Image File and files that may be
  2918.           currently involved in a file transfer (upload or download).  The
  2919.           result may be a loss of part or all of the data in the file. 
  2920.           This is a general DESQview no-no.  You may freely access these
  2921.  
  2922.  
  2923.  
  2924.                    {COMMO} (tm)  User Guide and Reference           page 49
  2925.  
  2926.  
  2927.           files in the Shell to DOS or Macro Processor features of {COMMO}
  2928.           (within the same window).
  2929.  
  2930.        >  If the memory allocated to the window is too small, {COMMO} will
  2931.           not be able to load the Online Help file.  Since the Online Help
  2932.           file is loaded only when requested, you needn't be concerned if
  2933.           you don't intend to use it.
  2934.  
  2935.        >  The video display may seem less smooth in DESQview.  This is a
  2936.           result of {COMMO} using the fastest possible display method, and
  2937.           is quite normal.  This effect can be reduced by specifying fewer
  2938.           clock ticks for foreground and background (4 and 4 seems to work
  2939.           well). 
  2940.  
  2941.        >  The Snow Checking option should not be used when {COMMO} is run
  2942.           under DESQview.  If you see "snow" type interference in your CGA
  2943.           display, use DESQview's own snow checking (request "synchronized
  2944.           access" in the Setup program).
  2945.  
  2946.           ________
  2947.  
  2948.           OmniView
  2949.           ________
  2950.  
  2951.        Display bleed-through may be avoided by telling OmniView that
  2952.        {COMMO} "Supports TopView Functions" or by using the "/T" switch on
  2953.        the OmniView command line.
  2954.  
  2955.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  2956.        most of which apply to OmniView as well.
  2957.  
  2958.           _________
  2959.  
  2960.           DoubleDOS
  2961.           _________
  2962.  
  2963.        Color displays require the "DISPLAY = TEXT" option in DDCONFIG.SYS. 
  2964.        Run {COMMO} in the bottom partition -- about 130k to 150k should
  2965.        suffice if you plan to use Online Help and/or external protocols. 
  2966.        Increase this size in proportion to the size of your Scrollback
  2967.        buffer.
  2968.  
  2969.        Some non-multi-tasker-aware, direct-screen-writing programs executed
  2970.        with the Macro Processor or Shell to DOS may not display properly. 
  2971.        If this happens you may have to run {COMMO} in the top partition.
  2972.  
  2973.        Use the supplied DBLDANSI.SYS driver in place of your ANSI.SYS for
  2974.        running other programs in this partition ({COMMO} doesn't use it).
  2975.  
  2976.        With this setup you may run any non-graphics program in the top
  2977.        partition, including direct screen writers.  
  2978.  
  2979.  
  2980.  
  2981.                    {COMMO} (tm)  User Guide and Reference           page 50
  2982.  
  2983.  
  2984.        Monochrome displays require the REFRESH option in DDCONFIG.SYS. 
  2985.        Refer to the DoubleDOS user's manual for information on this.
  2986.  
  2987.        See "TIPS on using {COMMO} with DESQview" in the previous section,
  2988.        most of which apply to DoubleDOS as well.
  2989.  
  2990.  
  2991.        ==========   ============
  2992.        Appendix C   Flow Control
  2993.        ==========   ============
  2994.  
  2995.        Flow Control is a signalling system used by communications devices
  2996.        to prevent data from being transmitted faster than it can be
  2997.        processed by the receiving system.  This is especially important
  2998.        when data is transferred at high speeds.
  2999.  
  3000.        Flow Control is initialized in the Setup File and is used by {COMMO}
  3001.        for both sending and receiving.  You may specify Software Flow
  3002.        Control, Hardware Flow Control or both.  Changes may be made at any
  3003.        time using the "[Alt-T]  Set Toggles" key command (or with the HFLOw
  3004.        and SFLOw macro functions) and will be effective immediately.
  3005.         
  3006.        Software Flow Control uses a control character called XOFF (or ^S)
  3007.        to signal the remote to pause.  XON (^Q) is the signal to "resume
  3008.        transmission."  This is normally used only for ASCII data, since
  3009.        these characters may appear randomly within binary data.  An XOFF
  3010.        pause will automatically be released in 20 seconds if no XON is
  3011.        received.  It will also be released if you type a character in the
  3012.        Terminal Screen.
  3013.  
  3014.        Hardware Flow Control uses the RTS/CTS lines in your RS-232C (serial
  3015.        port) cable to signal pause/resume without interfering with the
  3016.        data.  It should only be used when you are connected to a device
  3017.        which also recognizes RTS/CTS Flow Control (such as a high-speed
  3018.        modem or another computer connected with a null modem cable).  A
  3019.        CTS-off (send) pause will not be released automatically.  Turn off
  3020.        Hardware Flow Control (using Alt-T) if you need to override it.
  3021.  
  3022.        TIPS on using Flow Control:
  3023.  
  3024.        >  Your modem must be properly initialized to utilize flow control
  3025.           (consult the manual for details).
  3026.  
  3027.        >  Since Software Flow Control uses the XOFF (ASCII 19) and XON
  3028.           (ASCII 17) characters, these will not display on the screen.  If
  3029.           it is necessary to display them, Software Flow Control must be
  3030.           turned off.
  3031.  
  3032.        >  It is especially important to use Flow Control when the Print Log
  3033.           is on, since data is usually received faster than it can be
  3034.           printed.  If you type a character to the remote during a flow
  3035.           control pause, the remote may begin sending again (some systems
  3036.  
  3037.  
  3038.  
  3039.                    {COMMO} (tm)  User Guide and Reference           page 51
  3040.  
  3041.  
  3042.           resume on any character, not just XON).  You may have to turn off
  3043.           the Print Log if this happens.
  3044.  
  3045.  
  3046.        ==========   ==============================
  3047.        Appendix D   ASCII Character Representation
  3048.        ==========   ==============================
  3049.  
  3050.        Sometimes it is necessary to enter control characters and other
  3051.        special characters in the {COMMO} support files or as input to
  3052.        {COMMO} key commands.
  3053.  
  3054.        For example, a carriage return (typed with the Enter key) is used to
  3055.        terminate your typed input.  Therefore a carriage return must be
  3056.        represented by some other character (or characters) in order to be
  3057.        used as data.
  3058.  
  3059.        The process of translating represented characters to actual
  3060.        characters is done in many places in {COMMO}.  Some examples are:
  3061.  
  3062.           1)   Strings sent to the modem.  These include the Modem
  3063.                Initialization String, dialing prefixes and suffixes,
  3064.                telephone numbers, the Password String, strings defined in
  3065.                macro functions such as SEND, SETLook (the prompt response),
  3066.                VTCUr and VTPAd.
  3067.  
  3068.           2)   Strings defined in other macro functions such as LOOKfor,
  3069.                GOLOok, EXECute and DISPlay.
  3070.  
  3071.        All control characters may be represented using the (^) caret symbol
  3072.        (it is the shift character above the top row "6").  If you need to
  3073.        send a caret, use two carets (^^).
  3074.  
  3075.        For convenience, two "normal" characters have special meanings in
  3076.        certain contexts:
  3077.  
  3078.           The vertical bar (|) may be used to represent a carriage return. 
  3079.           If you need a vertical bar, use (^|).  In the EXECute function
  3080.           the vertical bar is never translated.
  3081.  
  3082.           The tilde (~) forces a one-half second delay when it is
  3083.           encountered in a string that is being sent to the modem.  If you
  3084.           need a tilde, use (^~).  This is effective only in strings that
  3085.           are sent to the modem.  In other strings the tilde is not
  3086.           translated.
  3087.  
  3088.        Finally, curly braces { } are very special characters and may not be
  3089.        used as data in the support files.  They are represented as follows,
  3090.        using parentheses:
  3091.  
  3092.           Left curly brace         ^(
  3093.           Right curly brace        ^)
  3094.  
  3095.  
  3096.  
  3097.                    {COMMO} (tm)  User Guide and Reference           page 52
  3098.  
  3099.  
  3100.  
  3101.        Here is a list of some of the most common control characters and how
  3102.        to represent them.  Upper or lower case may be used.
  3103.  
  3104.           Carriage return          ^M or |
  3105.           Linefeed                 ^J
  3106.           Formfeed                 ^L
  3107.           Escape                   ^[
  3108.           Bell                     ^G
  3109.           XOFF                     ^S
  3110.           XON                      ^Q
  3111.           End of file              ^Z
  3112.  
  3113.        Here is a table of all ASCII control characters.  Values are
  3114.        decimal:
  3115.  
  3116.             0  ... ^@      7  ... ^G      14 ... ^N      21 ... ^U
  3117.             1  ... ^A      8  ... ^H      15 ... ^O      22 ... ^V
  3118.             2  ... ^B      9  ... ^I      16 ... ^P      23 ... ^W
  3119.             3  ... ^C      10 ... ^J      17 ... ^Q      24 ... ^X
  3120.             4  ... ^D      11 ... ^K      18 ... ^R      25 ... ^Y
  3121.             5  ... ^E      12 ... ^L      19 ... ^S      26 ... ^Z
  3122.             6  ... ^F      13 ... ^M      20 ... ^T      27 ... ^[
  3123.  
  3124.        ASCII 28 to 31 and those in the extended graphic character set (128
  3125.        to 255), may be typed using the ALT-NUMERIC-KEYPAD method as
  3126.        follows:
  3127.  
  3128.           1.   Hold down the Alt key (and keep it down).
  3129.           2.   Enter the ASCII code in decimal using the numeric keypad
  3130.                keys (1, 2 or 3 digits are ok).
  3131.           3.   Release the Alt key.
  3132.  
  3133.  
  3134.        ==========   ==================
  3135.        Appendix E   Terminal Emulation
  3136.        ==========   ==================
  3137.  
  3138.        Terminal Emulation Type is indicated on the status line (to the
  3139.        right of the Serial Port Parameters string).  Available types are:
  3140.  
  3141.                A   ANSI-BBS   Used on bulletin boards and other systems.
  3142.                V   VT102      Used on minicomputers and mainframes.
  3143.                T   TTY        Supports only the basic control characters.
  3144.  
  3145.        The Terminal Emulation Type (as defined by the Default Dialing
  3146.        Parameter string) will be set whenever a system is dialed.  It may
  3147.        be changed temporarily using the Alt-P key command or the PARMs
  3148.        macro function.  The Default Dialing Parameters may be changed using
  3149.        the Alt-P key command or the DPARms macro function.
  3150.  
  3151.        TIPS on using terminal emulation:
  3152.  
  3153.  
  3154.  
  3155.                    {COMMO} (tm)  User Guide and Reference           page 53
  3156.  
  3157.  
  3158.  
  3159.        >  Whenever a change is made, a reset of mode parameters will be
  3160.           performed.  It is therefore important that the change be made
  3161.           BEFORE (or at the time of) connecting with a host (mode settings
  3162.           may be transmitted by the host).
  3163.  
  3164.        >  If some screens do not look right when VT102 emulation is used,
  3165.           you may need to turn LINEWRAP off (it defaults to on).
  3166.  
  3167.        >  Linewrap may be turned on/off locally using the DISPlay macro
  3168.           function.  Place one of the following in your login macro (or
  3169.           assign one of them to a key and execute it manually):
  3170.  
  3171.                     {display ,,,^[[?7h}      linewrap ON
  3172.                     {display ,,,^[[?7l}      linewrap OFF
  3173.  
  3174.        >  If colors do not always look right, it may be necessary to set
  3175.           the Terminal Screen colors in the Setup File to {07}.  See the
  3176.           note under "Colors" in the section "[Alt-G]  Setup File."
  3177.  
  3178.  
  3179.        Printer Support
  3180.        ===============
  3181.  
  3182.        {COMMO} supports the ANSI/VT102 printer functions, controlled by the
  3183.        remote system.
  3184.  
  3185.           The "Printer ON/OFF" function will turn {COMMO}'s Print Log
  3186.           ON/OFF.
  3187.  
  3188.           The "Dedicated Printing" function will send all input from the
  3189.           serial port directly to the printer.  This allows for
  3190.           "transparent" transmission of printer data, including control
  3191.           codes.
  3192.  
  3193.           The "Print Screen" function will print the entire current screen.
  3194.  
  3195.        The printer should be on and ready to print when these functions are
  3196.        used.  When "Dedicated Printing" is active no characters will be
  3197.        displayed on the screen.
  3198.  
  3199.  
  3200.        ANSI-BBS Keyboard Support
  3201.        =========================
  3202.  
  3203.        The sample Macro File is set up so you can use the PC keypad keys
  3204.        (arrow keys, PgUp, PgDn, etc.) with most BBS full-screen editors.
  3205.  
  3206.  
  3207.  
  3208.                    {COMMO} (tm)  User Guide and Reference           page 54
  3209.  
  3210.  
  3211.        VT102 Keyboard Simulation
  3212.        =========================
  3213.  
  3214.        Two keyboard files, VT102-1.MAC and VT102-2.MAC, provide support to
  3215.        simulate the VT102 keyboard.  You may merge one of these into
  3216.        COMMO.MAC if you intend to use VT102 all the time (replace the ANSI-
  3217.        BBS keys).  Be sure that you have no conflicting key-labels
  3218.        (remember that {COMMO} will use the first occurrence of a key-
  3219.        label).
  3220.  
  3221.        Or you can use the MACLoad function in your login macro to load the
  3222.        VT102 file automatically when you connect to the host.  Using the
  3223.        "r" option of MACLoad will reload COMMO.MAC at disconnect.  For
  3224.        example:
  3225.  
  3226.           {macload vt102-1.mac,,r}
  3227.  
  3228.        Both files support the following PC keypad functions (^ indicates
  3229.        the Ctrl key):
  3230.  
  3231.                Four cursor (arrow) keys
  3232.                Home   - Home cursor
  3233.                ^Home  - Insert line
  3234.                PgUp   - Page up
  3235.                ^PgUp  - Delete line
  3236.                PgDn   - Page down
  3237.                ^PgDn  - Clear screen
  3238.                End    - End of line
  3239.                Ins    - Insert mode
  3240.                Del    - Delete
  3241.                ^bs   -  Ctrl backspace (delete)
  3242.  
  3243.        VT102 numeric keypad keys are auto-switched by the host system
  3244.        between numeric mode and application mode.
  3245.  
  3246.        The four cursor keys are auto-switched between cursor mode and
  3247.        application mode.
  3248.  
  3249.        These files may be modified to create any keyboard support you
  3250.        desire (see description of VTCUr and VTPAd functions in the section
  3251.        "{COMMO} Macro Functions."
  3252.  
  3253.           ___________
  3254.  
  3255.           VT102-1.MAC
  3256.           ___________
  3257.  
  3258.        This file contains keyboard assignments that work best with the
  3259.        enhanced keyboard (because of the separate cursor keys, etc.).
  3260.  
  3261.        With Numlock ON the ten digits and period will simulate their
  3262.        equivalent VT102 functions.  In addition:
  3263.  
  3264.  
  3265.  
  3266.                    {COMMO} (tm)  User Guide and Reference           page 55
  3267.  
  3268.  
  3269.  
  3270.                F1 to F4 simulate PF1 to PF4
  3271.                Grey * is used for comma
  3272.                Grey - is used for dash
  3273.                Grey + is used for Enter
  3274.  
  3275.           ___________
  3276.  
  3277.           VT102-2.MAC
  3278.           ___________
  3279.  
  3280.        This file contains keyboard assignments that work best with the 83-
  3281.        key keyboard (because of the location of the function keys on the
  3282.        left side).
  3283.  
  3284.        The following diagram shows how the ten function keys (Fn) and ten
  3285.        shifted function keys (SFn) relate to the VT102 keypad keys:
  3286.  
  3287.  
  3288.                F1=  PF1    F2=  PF2    SF1=  PF3    SF2=  PF4
  3289.  
  3290.                F3=   7     F4=   8     SF3=   9     SF4=   -
  3291.  
  3292.                F5=   4     F6=   5     SF5=   6     SF6=   ,
  3293.         
  3294.                F7=   1     F8=   2     SF7=   3     SF8=   Enter
  3295.  
  3296.                F9=   0     F10=  0     SF9=   .     SF10=  Enter
  3297.  
  3298.  
  3299.        ==========   ================
  3300.        Appendix F   Usage Log Format
  3301.        ==========   ================
  3302.  
  3303.        The {On} and {Off} entries are self-explanatory.
  3304.  
  3305.        Here is an example of a file transfer entry:
  3306.  
  3307.           {SX} 0  c:\ul\nlbbs.rep  1664  CRC 1024  0 errors 
  3308.  
  3309.                {SX}                Send {SX} or receive {RX} with Xmodem.
  3310.                0                   Transfer successful (0) or failed (1).
  3311.                c:\ul\nlbbs.rep     Pathname of file.
  3312.                1664                Bytes transferred.
  3313.                CRC 1024            Transfer method.
  3314.                0 errors            Total number of errors (corrected if
  3315.                                    transfer was successful).
  3316.  
  3317.  
  3318.  
  3319.                    {COMMO} (tm)  User Guide and Reference           page 56
  3320.  
  3321.  
  3322.        ==========   ==========================
  3323.        Appendix G   Error Message Explanations
  3324.        ==========   ==========================
  3325.  
  3326.        If you get an error message that you don't understand, check below
  3327.        for additional information.
  3328.  
  3329.        ________________________________
  3330.  
  3331.        Sorry, out of memory
  3332.        Not enough memory for Scrollback
  3333.        ________________________________
  3334.  
  3335.           These messages may occur at program startup.  Check the
  3336.           following:
  3337.  
  3338.           1)   {COMMO} cannot allocate its internal buffers.  You must make
  3339.                more memory available.
  3340.  
  3341.           2)   {COMMO} cannot load the Dialing Directory and/or Macro File. 
  3342.                Try reducing the size of either of these files.  Removing
  3343.                comments may help.  Or make more memory available.
  3344.  
  3345.           3)   {COMMO} cannot allocate the Scrollback Buffer.  Reduce its
  3346.                size or make more memory available.
  3347.  
  3348.        _______________________________
  3349.  
  3350.        Cannot locate command processor
  3351.        _______________________________
  3352.  
  3353.           This is an unusual condition.  Type "SET" at the DOS prompt and
  3354.           be sure there is a "COMSPEC=" in the list.  If there is, make
  3355.           sure that COMMAND.COM is in the path specified.
  3356.  
  3357.        _______________________
  3358.  
  3359.        Not enough memory
  3360.        Program file not found
  3361.        Unable to execute shell
  3362.        _______________________
  3363.  
  3364.           A problem was encountered during Shell to DOS or EXEC:
  3365.  
  3366.           1)   There may not be enough memory to execute the command
  3367.                processor or external program you have specified.
  3368.  
  3369.           2)   The program file you specified in an EXECute function using
  3370.                the "D" switch cannot be located.  Make sure you specify the
  3371.                full path and filename.
  3372.  
  3373.  
  3374.  
  3375.                    {COMMO} (tm)  User Guide and Reference           page 57
  3376.  
  3377.  
  3378.           3)   Some other system error condition may exist.  Make sure that
  3379.                COMMAND.COM is still available in the "COMSPEC=" path.
  3380.  
  3381.        ___________________________
  3382.  
  3383.        Hardware flow control pause
  3384.        ___________________________
  3385.  
  3386.           Hardware Flow Control is in effect and the remote system (or your
  3387.           modem) has requested a pause.  Try waiting a few seconds for the
  3388.           pause to clear; if that fails you may have to turn off Hardware
  3389.           Flow Control (use Alt-T, Set Toggles).
  3390.  
  3391.        _________________________________________
  3392.  
  3393.        File space full!  Delete unnecessary text
  3394.        _________________________________________
  3395.  
  3396.           {COMMO} allows about 65,000 bytes when editing any file (the
  3397.           Dialing Directory and Macro File occupy a common file space). 
  3398.           This limit may be reached when editing any of the files with the
  3399.           Internal Editor.  If this happens you must reduce the size of the
  3400.           file in question.  Try removing comment lines and any other
  3401.           extraneous information.
  3402.  
  3403.           This message may also be the result of loading a resident program
  3404.           (TSR) in the Shell to DOS or via the EXEC macro function.  Other
  3405.           causes involve a corruption of DOS parameters and require
  3406.           rebooting.
  3407.  
  3408.        _____________________
  3409.  
  3410.        Dial command too long
  3411.        _____________________
  3412.  
  3413.           The dial command is limited to 128 characters.
  3414.  
  3415.        ________________________
  3416.  
  3417.        Unable to open file
  3418.        Unable to open Help File
  3419.        File not found
  3420.        Path not found
  3421.        Too many files
  3422.        ________________________
  3423.  
  3424.           Check the following:
  3425.  
  3426.           1)   Your "SET COMMO=" command in your AUTOEXEC.BAT file.  It may
  3427.                be specifying the wrong directory.
  3428.           2)   That the path exists where the file should be.
  3429.  
  3430.  
  3431.  
  3432.                    {COMMO} (tm)  User Guide and Reference           page 58
  3433.  
  3434.  
  3435.           3)   That the file itself exists (this won't be the problem if
  3436.                the file is being created).
  3437.           4)   Too many files may be open.  You may need to increase your
  3438.                FILES= parameter in CONFIG.SYS.
  3439.           5)   The Online Help File must be less than 64K bytes in size.
  3440.           6)   You cannot use an open Capture File for any other purpose.
  3441.  
  3442.        ____________________________________
  3443.  
  3444.        Capture File Closed, disk is full!
  3445.        Information not saved, disk is full!
  3446.        ____________________________________
  3447.  
  3448.           The Capture File and Screen Image File should be edited regularly
  3449.           to ensure that they are not occupying too much disk space.
  3450.  
  3451.  
  3452.                                    - end -
  3453.  
  3454.